VS Code용 Cloud Code를 사용한 Cloud Run 서비스 배포

이 문서에서는 Cloud Code를 시작하는 방법을 설명합니다.

샘플 'Hello, world' 애플리케이션에서 서비스를 만들고, Cloud Code를 사용하여 서비스를 공개적으로 배포하고, 라이브 서비스의 리소스 상태를 확인합니다.

시작하기 전에

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. 이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Cloud Run API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. 이 가이드에 기존 프로젝트를 사용하는 경우 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다. 새 프로젝트를 만든 경우에는 이미 필요한 권한이 있습니다.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Cloud Run API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    10.
  10. Git를 설치합니다. 샘플을 머신에 복사하려면 Git이 필요합니다.
  11. Docker를 설치합니다. 샘플 코드를 빌드하려면 Docker가 필요합니다. 로컬 사용자 계정에서 컨테이너를 빌드할 수 있는지 확인합니다.
  12. 아직 설치하지 않은 경우 Cloud Code 플러그인을 설치합니다.

    13. 필요한 역할

    이 빠른 시작을 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

    역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

    커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

서비스 만들기

샘플 서비스 애플리케이션을 만들려면 다음 단계를 따르세요.

  1. Cloud Code 상태 표시줄에서 활성 프로젝트 이름을 클릭합니다.

    상태 표시줄의 활성 프로젝트 이름

  2. 빠른 선택 메뉴가 표시되면 새 애플리케이션을 선택합니다.

  3. 애플리케이션 유형으로 Cloud Run 애플리케이션을 선택합니다.

  4. 샘플 애플리케이션 목록에서 원하는 언어를 선택합니다.

    예를 들어 Node.js: Cloud Run을 선택하면 Node.js에서 'Hello, world' 서비스 애플리케이션이 생성됩니다.

  5. 서비스 소스 코드의 파일 시스템 위치를 확인하고 (또는 필요한 경우 수정) 새 애플리케이션 만들기를 클릭합니다.

    선택한 서비스의 README.md 파일 미리보기가 VS Code에서 열립니다.

Cloud Run에 배포

Cloud Run에 서비스를 배포하려면 다음 단계를 따르세요.

  1. 명령어 팔레트를 연 다음(Ctrl/Cmd+Shift+P를 누르거나 보기 > 명령어 팔레트 클릭) Cloud Run에 배포 명령어를 실행합니다.

  2. Cloud Run에 배포 창에서 Google Cloud 프로젝트를 설정합니다.

  3. 나머지 기본 설정을 수락한 후 배포를 클릭합니다.

    그러면 Cloud Code가 이미지를 빌드하여 레지스트리에 푸시하고 서비스를 Cloud Run에 배포합니다.

  4. 실행 중인 서비스를 보려면 Cloud Run에 배포 대화상자 상단에 표시되는 URL을 엽니다.

리소스 상태 보기

Cloud Run 서비스 브라우저를 사용하여 Cloud Run 서비스의 상태를 볼 수 있습니다.

  1. VS Code 작업 표시줄에서 Cloud Code를 클릭합니다.
  2. Cloud Run 섹션을 펼쳐 Cloud Run 서비스를 확인합니다.
  3. 서비스를 클릭하여 속성을 확인합니다.

로그 보기

Cloud Code와 함께 제공되는 로그 뷰어를 사용하여 배포된 서비스의 로그를 볼 수도 있습니다.

로그를 보려면 다음 단계를 따르세요.

  1. VS Code 작업 표시줄에서 Cloud Code를 클릭합니다.
  2. Cloud Run 섹션을 펼쳐 Cloud Run 서비스를 확인합니다.
  3. Cloud Run 서비스를 마우스 오른쪽 버튼으로 클릭한 후 로그 보기를 클릭합니다.

삭제

프로젝트를 삭제하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔의 프로젝트 페이지로 이동합니다.

    프로젝트 페이지로 이동

  2. 이 빠른 시작에서 만든 프로젝트를 선택한 후 삭제를 클릭합니다.

  3. 확인할 프로젝트 ID를 입력한 후 종료를 클릭합니다.

    그러면 프로젝트가 종료되고 삭제 일정이 예약됩니다.

기존 프로젝트를 사용하고 이 빠른 시작을 위해 만든 리소스를 삭제하려는 경우:

  • 컨테이너 이미지: 서비스를 사용하지 않을 때는 Cloud Run 요금이 청구되지 않지만 Artifact Registry에 컨테이너 이미지를 저장하는 요금이 청구될 수 있습니다. 이미지 삭제 단계는 이미지 삭제를 참조하세요.

  • Cloud Run 서비스: Cloud Run 서비스를 삭제하려면 탐색 메뉴를 사용하여Google Cloud 콘솔에서 Cloud Run으로 이동합니다. 삭제할 서비스를 선택하고 삭제를 클릭합니다.

다음 단계