App Engine 표준 환경에서 Node.js 앱 만들기

빠른 시작: App Engine 표준 환경에서 Node.js 앱 만들기

App Engine 표준 환경에서 Node.js 앱 만들기

리전 ID

REGION_ID는 앱을 만들 때 선택한 리전을 기준으로 Google에서 할당하는 축약된 코드입니다. 일부 리전 ID는 일반적으로 사용되는 국가 및 주/도 코드와 비슷하게 표시될 수 있지만 코드는 국가 또는 주/도와 일치하지 않습니다. 2020년 2월 이후에 생성된 앱의 경우 REGION_ID.r이 App Engine URL에 포함됩니다. 이 날짜 이전에 만든 기존 앱의 경우 URL에서 리전 ID는 선택사항입니다.

리전 ID에 대해 자세히 알아보세요.

확인

Python 2.7/3 |자바 8/11/17 |PHP 5/7+ |Ruby |Go 1.11 / 1.12+ |Node.js

이 빠른 시작은 App Engine에 샘플 앱을 배포하는 방법을 보여줍니다. App Engine용 앱 코딩에 대한 자세한 내용은 앱 빌드를 참조하세요.

App Engine이 자신에게 적합한 컴퓨팅 옵션인가요? Google Cloud에서 애플리케이션을 호스팅하는 다른 옵션을 확인해 보세요.

비용

이 가이드의 실행에는 비용이 발생하지 않습니다. 이 샘플 앱을 실행하는 것만으로는 무료 할당량이 초과되지 않습니다.

시작하기 전에

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. Cloud Build API 사용 설정

   API 사용 설정

5. Google Cloud CLI를 설치합니다.

6. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

   gcloud init

7. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기로 이동

8. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

9. Cloud Build API 사용 설정

   API 사용 설정

10. Google Cloud CLI를 설치합니다.

11. gcloud CLI를 초기화하려면 다음 명령어를 실행합니다.

    gcloud init

추가 기본 요건

1. 프로젝트로 App Engine 앱을 초기화하고 리전을 선택합니다.

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   메시지가 표시되면 App Engine 애플리케이션을 위치할 리전을 선택합니다.

   주의: 앱의 리전을 설정한 후에는 변경할 수 없습니다.

2. 다음 기본 요건을 설치합니다.

   • Git을 다운로드하여 설치합니다.
   • Node.js 개발 환경을 준비합니다.

App Engine 위치

App Engine은 리전을 기반으로 합니다. 즉, 앱을 실행하는 인프라가 특정 리전에 위치해 있으며 해당 리전 내의 모든 영역에서 중복으로 사용할 수 있도록 Google이 관리합니다.

앱을 실행하는 리전을 선택하는 데 있어 중요한 기준은 지연 시간, 가용성 또는 내구성 요구사항입니다. 일반적으로 앱 사용자와 가장 가까운 리전을 선택할 수 있지만 App Engine을 사용할 수 있는 위치와 앱에서 사용하는 다른 Google Cloud 제품 및 서비스의 위치도 고려해야 합니다. 여러 위치에서 서비스를 사용하면 앱의 지연 시간과 가격 책정에 영향을 미칠 수 있습니다.

앱의 리전을 설정한 후에는 변경할 수 없습니다.

참고: App Engine 명령어 및 Google Cloud 콘솔에서 europe-west 및 us-central이라고 부르는 두 위치를 Google 문서에서는 각각 europe-west1 및 us-central1이라고 부릅니다.

App Engine 애플리케이션을 이미 만든 경우 다음 중 한 가지 방법으로 해당 리전을 볼 수 있습니다.

• gcloud app describe 명령어를 실행합니다.

• Google Cloud 콘솔에서 App Engine 대시보드를 엽니다. 이 리전은 페이지 상단 근처에 표시됩니다.

확인

이 빠른 시작에서는 Express.js 프레임워크를 사용하여 작성된 간단한 Node.js 애플리케이션을 설명합니다.

중요: Windows에서 환경을 최적화하려면 npm install -g npm을 실행하여 Node.js 패키지 관리자(npm)를 최신 버전으로 업그레이드하세요. 최신 npm은 종속 항목을 플랫 디렉터리 구조에 설치하므로 Windows 최대 경로 길이(255자(영문)) 제한을 초과할 가능성이 낮습니다. 이전 버전의 npm을 계속 사용하려는 경우에는 프로젝트를 드라이브 루트(예: C:\)로 옮겨 경로 길이를 줄이세요.

샘플 코드 다운로드

간단한 Hello World 앱을 사용하여 App Engine에 웹 서비스 배포에 대한 개요를 간략히 살펴봅니다. 다음 단계를 따라 코드를 개발 환경으로 다운로드할 수 있습니다.

1. Node.js 샘플 앱 저장소를 다운로드합니다.

   Cloud Shell

   Cloud Shell에서 저장소를 엽니다.

   

   로컬 머신

   ZIP 파일로 저장소를 다운로드하고 압축을 풉니다.

   또는 git로 저장소를 클론합니다.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
   

2. Hello World 앱이 있는 디렉터리로 변경합니다.

   cd nodejs-docs-samples/appengine/hello-world/standard
   

로컬에서 Hello World 실행

1. 프로젝트의 종속 항목을 설치합니다.

   npm install
   

2. HTTP 서버를 시작합니다.

   npm start
   

3. 웹 브라우저에서 앱을 확인합니다.

   Cloud Shell

   Cloud Shell 툴바에서 웹 미리보기 를 클릭하고 포트 8080에서 미리보기를 선택합니다.

   로컬 머신

   웹브라우저에서 http://localhost:8080으로 이동합니다.

   그러면 'Hello, world!' 메시지가 페이지에 표시됩니다.

4. 터미널 창에서 Ctrl+C를 눌러 HTTP 서버를 중지합니다.

App Engine에서 Hello World 배포 및 실행

1. hello-world/standard 디렉터리에서 다음 명령어를 실행하여 App Engine에 Hello World 앱을 배포합니다.

   gcloud app deploy
   

2. https://PROJECT_ID.REGION_ID.r.appspot.com에서 라이브 앱을 봅니다.

   gcloud app browse
   

이제 App Engine 인스턴스에서 실행되는 웹 서버에서 'Hello, world!' 메시지를 전달합니다.

수고하셨습니다. Node.js 웹 서비스가 App Engine에 성공적으로 배포되었습니다.

정리

App Engine에 대해 계속 알아보려면 Cloud 프로젝트를 유지하고 앱 빌드를 따르세요.

또는 Cloud 프로젝트를 삭제하여 프로젝트 내에 사용된 모든 리소스에 대한 비용 청구를 중지할 수 있습니다.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.
• 프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
• 커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.
1. Google Cloud 콘솔에서 리소스 관리 페이지로 이동합니다.

   리소스 관리로 이동

2. 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제를 클릭합니다.
3. 대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 프로젝트를 삭제합니다.

다음 단계

App Engine에 웹 서비스 배포에 대해 살펴보았습니다. 이제 앱 빌드를 진행하여 App Engine에서의 Node.js 사용에 대해 더욱 심층적으로 알아보세요.

App Engine 표준 환경의 Node.js 런타임에 대한 자세한 내용은 Node.js 런타임 환경을 참조하세요.