빠른 시작: Cloud Code를 사용하여 Cloud Run 서비스 배포

이 페이지에서는 Cloud Code를 시작하는 방법을 보여줍니다.

샘플 애플리케이션을 사용하여 Cloud Run에서 실행되는 Hello World 서비스를 설정하고, Cloud Run에 서비스를 배포하고, 라이브 서비스의 리소스 상태를 확인합니다.

Cloud Code를 사용하여 새로운 Cloud Run 서비스 만들기

Apple M 시리즈 실리콘에서 이 빠른 시작을 실행하는 경우 애플리케이션은 요금이 청구될 수 있는 Cloud Build를 사용하여 빌드됩니다. 자세한 내용은 Apple M 시리즈 실리콘의 Cloud Code 지원을 참조하세요.

시작하기 전에

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

    프로젝트 선택기로 이동

  3. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. Cloud Run API를 사용 설정합니다.

    API 사용 설정

Cloud Code 설치

IntelliJ용 Cloud Code 플러그인을 설치하려면 다음 안내를 따르세요.

  1. 아직 설치하지 않았다면 JetBrains IDE 버전 2020.3 이상(예: IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand)을 설치합니다.

  2. Apple M 시리즈 실리콘에서 Cloud Code를 실행하는 경우 Rosetta 2를 설치합니다. 그러면 Cloud Code가 관리형 종속 항목으로 kubectl을 설치할 수 있습니다.

    Rosetta 2를 설치하지 않으려면 관리형 종속 항목을 해제하고(IntelliJ IDEA > 환경설정 > 도구 > Cloud Code > 종속 항목) 종속 항목 커스텀 버전에 설명된 대로 kubectl의 고유 ARM 버전을 설치합니다.

  3. 종속 항목을 설치합니다.

    • 모든 Cloud Platform의 경우 Docker 클라이언트(Docker 레지스트리로 인증됨)가 머신의 PATH에 설치되어 있는지 확인합니다(폴더는 PATH의 디렉터리 아래에 표시되어야 함). docker -v를 실행하여 Docker가 이미 설치되어 있는지 확인합니다.
    • Cloud Code는 필요한 다른 종속 항목을 자동으로 설치합니다.
  4. IntelliJ IDEA 또는 기타 지원되는 JetBrains IDE를 엽니다.

  5. IDE가 열리면 이 페이지를 새로고칩니다.

    이제 아래 버튼을 클릭하여 Cloud Code 플러그인을 직접 설치할 수 있습니다.

    버튼을 클릭하면 열린 IDE 내에서 설치 대화상자가 실행됩니다. 확인을 클릭하여 Cloud Code를 설정합니다.

서비스 만들기

기존 샘플을 사용하여 새 서비스를 만들려면 다음 안내를 따르세요.

  1. IDE에서 파일 > 새 프로젝트를 열고 Cloud Code: Cloud Run을 선택합니다.
  2. 샘플 애플리케이션의 프로그래밍 언어를 선택한 후 다음을 클릭합니다. 기존 샘플 앱 목록에서 서비스 만들기
  3. 프로젝트 이름을 지정한 후 마침을 클릭합니다.

    Cloud Code가 샘플 애플리케이션을 클론하고, 새로 생성된 프로젝트를 사용하도록 열고, 필요한 Cloud Run 실행 구성을 만듭니다.

  4. 자바 샘플 애플리케이션을 선택한 경우 메시지가 표시되면 Maven 프로젝트 로드를 클릭합니다.

    Maven 빌드 스크립트에서 알림 발견 - Maven 프로젝트 로드, 건너뛰기 또는 도움말 선택

이제 Hello World 서비스를 실행할 수 있습니다. Cloud Code가 파일 시스템에서 변경사항을 감시하므로 서비스를 거의 실시간으로 수정하고 다시 실행할 수 있습니다.

Cloud Run에 서비스 배포

서비스를 디버그하려면 다음 단계를 따르세요.

  1. 탐색 메뉴의 실행/디버그 구성 선택기에서 자동으로 생성된 실행 구성인 Cloud Run: 배포를 선택합니다.

    Apple M 시리즈 실리콘에서 이 빠른 시작을 실행하는 경우 애플리케이션이 Cloud Build를 사용하여 빌드됩니다. Cloud Build 가격 책정에 대한 자세한 내용은 가격 책정을 참조하세요.

  2. 실행 실행 작업 아이콘을 클릭합니다. 그러면 구성 수정 창이 나타납니다.

  3. Google Cloud 프로젝트 ID를 설정합니다.

  4. 배포 플랫폼의 리전을 선택합니다.

    이 빠른 시작에서는 기본 플랫폼 옵션인 Cloud Run(완전 관리형)을 배포 플랫폼으로 사용합니다.

  5. 실행을 클릭합니다.

  6. 출력 창에 표시된 URL을 따라 실행 중인 서비스를 확인합니다.

  7. 출력 창에 표시된 로그 URL에 따라 서비스 상태(측정항목, 버전 세부정보 등)를 볼 수도 있습니다.

    Cloud Console에서 서비스 상태 보기

리소스 상태 보기

실행 중인 서비스 리소스의 상태를 보려면 다음 단계를 따르세요.

  1. Cloud Run 탐색기로 이동합니다. 오른쪽의 측면 패널에서 액세스할 수 있습니다.

    오른쪽 측면 패널에 강조표시된 Cloud Run 탐색기 탭

  2. 서비스나 버전 속성을 표시하려면 탐색기에서 서비스 또는 버전을 클릭합니다.

    서비스가 선택되고 아래에 속성이 표시된 Cloud Run 탐색기

  3. 버전의 로그를 보려면 버전을 마우스 오른쪽 버튼으로 클릭한 다음 Cloud 로그 보기를 클릭합니다.

    로그를 볼 버전을 마우스 오른쪽 버튼으로 클릭합니다.

삭제

이 빠른 시작을 위해 프로젝트를 만든 경우 불필요한 비용이 청구되지 않도록 삭제해야 합니다.

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

    프로젝트 페이지로 이동

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

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

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

  • 컨테이너 이미지: 서비스를 사용하지 않을 때는 Cloud Run 요금이 청구되지 않지만 Container Registry에 컨테이너 이미지를 저장하는 요금이 청구될 수 있습니다. 이미지를 삭제하려면 이미지 삭제의 단계를 따르세요.
  • Cloud Run 서비스: Cloud Run 서비스를 삭제하려면 탐색 메뉴를 사용하여 Cloud Console에서 Cloud Run으로 이동합니다. 삭제하려는 서비스를 선택한 후 삭제를 클릭합니다.

다음 단계

지원 받기

IntelliJ IDE에서 의견을 제출하거나 문제를 신고하려면 도구 > Cloud Code > 도움말 / 정보 > 의견 제출 또는 문제 신고로 이동하여 GitHub에 문제를 신고하거나 Stack Overflow에서 질문합니다.

Google Cloud Slack 커뮤니티에 속한 #cloud-code 채널에도 가입할 수 있습니다.