개발을 위한 서비스 구성
서비스를 로컬로 실행하려면 먼저 구성을 지정해야 합니다.
- 명령어 팔레트(Ctrl/Cmd+Shift+P로 액세스 가능)을 사용해 Cloud Run 에뮬레이터에서 실행을 선택합니다.
Cloud Run Emulator에서 실행/디버그 대화상자가 열리고 구성의 사양을 설정할 수 있습니다.
선택사항: 구성 맞춤설정
위 설정 외에도 고급 설정 섹션을 사용하여 서비스 계정 및 환경 변수와 같은 고급 설정을 지정할 수 있습니다.
환경 변수:
다음 환경 변수는 실행 중인 컨테이너에 자동으로 추가됩니다.
이름 | 설명 | 예시 |
PORT | HTTP 서버가 리슨하는 포트입니다. | 8080 |
K_SERVICE | 실행되는 Cloud Run 서비스의 이름입니다. | hello-world |
K_REVISION | 실행되는 Cloud Run 버전의 이름입니다. | hello-world.1 |
K_CONFIGURATION | 버전을 만든 Cloud Run 구성의 이름입니다. | hello-world |
로컬로 서비스 실행
- 원하는 설정을 정의한 후 실행을 클릭하면 됩니다.
출력 창에서 배포 상태를 모니터링합니다.
완료되면 출력 창에 표시되는 다음 URL에 따라 실행 중인 서비스를 볼 수 있습니다.
출력 창에서 자세한 Cloud Run 보기로 전환하여 상세 로그를 확인합니다.다.
세션이 완료되면 Cloud Code 상태 표시줄을 통해 애플리케이션 및 리소스를 모니터링할 수 있는 추가 컨텍스트 메뉴 옵션을 사용할 수 있습니다.
- 배포 로그 열기: Cloud Code 로그 뷰어를 사용하여 특정 배포의 애플리케이션 로그를 엽니다.
- 서비스 URL 열기: 웹브라우저에서 특정 서비스의 애플리케이션 서비스 URL을 엽니다.
시계 모드 켜기/끄기: 현재 세션의 시계 모드를 전환합니다(디버그 세션에는 사용할 수 없음).
배포를 중지하려면 현재 배포의 작업 모음에서 중지 버튼을 클릭합니다.
보안 비밀 저장
코드에 API 키, 비밀번호, 인증서와 같이 민감할 수 있는 데이터가 포함된 경우 이를 보안 비밀로 저장하는 것이 좋습니다. Cloud Code를 사용하면 이러한 보안 비밀을 Secret Manager에 안전하게 저장하고 필요할 때 프로그래매틱 방식으로 가져올 수 있습니다. Cloud Code를 사용하여 보안 비밀을 만들고 관리하는 방법에 대한 자세한 내용은 Secret Manager 가이드를 참조하세요.
기존 launch.json 구성 맞춤설정
서비스 실행 방법을 구성하려면 skaffold.yaml을 맞춤설정하고 .vscode/launch.json
에 다음 필드를 지정할 수 있습니다.
- watch: 실행 모드일 때 작업공간의 변경사항을 감시하고 서비스를 다시 실행합니다. 명시적으로 false로 설정하지 않는 한 기본적으로 true입니다.
- build: 이미지를 빌드하는 데 사용할 빌더(Docker, buildpacks)를 지정합니다.
- image: 사용할 이미지의 이름을 지정합니다.
- service: 사용할 Cloud Run 서비스를 지정합니다.
- debug: 로컬 경로를 원격 컨테이너의 경로에 매핑하는 원격 경로 매핑과 같은 원하는 디버그 설정을 지정합니다.