서비스 관리

이 페이지에서는 서비스를 만들고 서비스에 대한 정보를 확인하는 방법을 설명합니다. 서비스는 Cloud Run의 기본 리소스입니다. 각 서비스에는 시간이 지나 새 버전이 배포될 때도 변경되지 않는 고유한 영구 URL이 있습니다.

Cloud Run(완전 관리형)의 경우 서비스의 영구 도메인은 서비스 이름과 해시로 구성됩니다.

서비스 만들기

컨테이너 이미지를 처음으로 배포하여 새 서비스를 만듭니다. 자세한 내용은 새 서비스 배포를 참조하세요.

프로젝트의 서비스 목록 보기

Cloud Console 또는 gcloud 명령줄을 사용하여 프로젝트에서 사용 가능한 서비스 목록을 볼 수 있습니다.

Console

서비스 목록을 보려면 다음 안내를 따르세요.

  1. Cloud Run으로 이동

  2. 프로젝트에 대해 표시된 서비스 목록을 검토합니다.

    서비스 목록

명령줄

프로젝트의 서비스 목록을 표시하려면 다음 명령어를 사용하세요.

gcloud run services list

각 서비스에는 연결된 URL이 있습니다.

이 목록을 할당된 라벨과 같은 서비스 정의 속성별로 필터링할 수 있습니다.

Cloud Code

Cloud Code를 사용하여 서비스 목록을 보려면 IntelliJVisual Studio Code용 Cloud Run 탐색기 가이드를 참조하세요.

서비스 복사

Cloud Console 또는 YAML을 사용하여 기존 서비스의 사본을 만들 수 있습니다. 이름과 리전을 포함하여 사본에서 원하는 사항을 변경할 수 있습니다.

Console

서비스를 복사하려면 다음 안내를 따르세요.

  1. Cloud Run으로 이동

  2. 표시된 프로젝트의 서비스 목록에서 복사할 서비스를 선택합니다.

    서비스 목록

    1. 복사를 클릭합니다.

    2. 서비스 사본 페이지에서 리전 등 변경할 값을 설정하거나 변경합니다. 동일한 리전을 유지할 경우 서비스에 새 이름을 제공해야 합니다.

    3. 만들기를 클릭하여 사본을 만들고 새 서비스 이름을 사용하여 배포합니다.

YAML

YAML 형식으로 정리된 결과를 반환하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드하고 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud beta run services replace 명령어를 사용하여 수정된 YAML을 업로드할 수 있습니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    gcloud run services describe SERVICE --format export > service.yaml
  2. 다양한 구성 페이지의 설명대로 서비스 구성을 원하는 대로 변경합니다.

     apiVersion: serving.knative.dev/v1
     kind: Service
     metadata:
       annotations:
         ...
       name: SERVICE
       ...
     spec:
       template:
         metadata:
           annotations:
           ...
           name: REVISION-NAME
    
    • 사본을 다른 리전에 배포하지 않는 경우 SERVICE를 사본에 사용할 이름으로 바꿉니다. 사본을 다른 리전에 배포하는 경우에는 이전 이름을 사용하면 됩니다.
    • REVISION-NAME 값이 서비스 이름(SERVICE)으로 시작하는지 확인합니다. 예를 들어 새 서비스 이름이 mynewfoo이면 버전 이름은 mynewfoo-whatever 형식이어야 합니다. 원하는 경우 값을 모두 삭제합니다. 그러면 새 버전 이름이 자동으로 생성됩니다.
  3. 다음 명령어를 사용하여 서비스를 복사합니다.

    gcloud beta run services replace service.yaml

    --region 플래그를 사용하여 다른 리전에 사본을 배포합니다.

서비스 세부정보 보기

서비스에 대한 세부정보를 보는 방법은 다음과 같습니다.

Console

서비스 세부정보를 보려면 다음 안내를 따르세요.

  1. Cloud Run으로 이동

  2. 프로젝트에 대해 표시된 서비스 목록에서 원하는 서비스를 클릭하여 서비스 세부정보 뷰를 엽니다.

    버전 목록

  3. 버전, 로그세부정보 탭을 확인합니다. 버전 탭에는 버전 목록이, 로그 탭에는 서비스 로그가, 세부정보 탭에는 현재 인증 또는 연결 설정이 표시됩니다.

명령줄

서비스에 대한 세부정보를 보려면 다음 명령어를 실행하세요.

gcloud run services describe SERVICE
SERVICE를 서비스 이름으로 바꿉니다.

--format 플래그를 사용하여 출력 형식을 지정할 수 있습니다. YAML 형식의 예시는 다음과 같습니다.

gcloud run services describe SERVICE --format yaml

--format export를 사용하면 자동으로 생성된 라벨이나 상태 없이 YAML로 내보낼 수 있습니다.

gcloud run services describe SERVICE --format export

--format 플래그를 사용하여 서비스의 URL을 가져올 수도 있습니다.

gcloud run services describe SERVICE --format='value(status.url)'

Cloud Code

Cloud Code를 사용하여 서비스 세부정보를 보려면 IntelliJVisual Studio Code용 Cloud Run 탐색기 가이드를 참조하세요.

서비스 버전에 대한 자세한 내용은 버전 관리를 참조하세요.

Cloud Run for Anthos 서비스 연결 설정 변경

Cloud Run for Anthos 서비스의 연결 옵션에는 두 가지가 있습니다.

  • 외부: 서비스에 대한 외부 액세스를 허용합니다.
  • 내부: Istio를 사용하는 클러스터의 다른 Cloud Run for Anthos 서비스로만 액세스를 제한합니다.

Console 또는 gcloud 명령줄을 사용하여 설정을 변경할 수 있습니다.

Console

서비스 연결 설정을 변경하려면 다음 안내를 따르세요.

  1. Cloud Run으로 이동

  2. 프로젝트에 대해 표시된 서비스 목록에서 원하는 서비스를 클릭하여 서비스 세부정보 뷰를 엽니다.

  3. 세부정보 탭을 클릭합니다.

    세부정보 탭

  4. 연결 행에서 현재 설정 옆에 있는 수정 아이콘을 클릭합니다.

  5. 원하는 설정을 선택하고 저장을 클릭합니다.

명령줄

서비스 연결 설정을 변경하려면 다음 명령어를 실행하여 원하는 연결 설정으로 서비스를 업데이트합니다.

gcloud run services update [SERVICE] --connectivity=[OPTION]
  • [SERVICE]를 업데이트할 서비스의 이름으로 바꿉니다. 이 매개변수를 완전히 생략할 수 있지만 생략하면 서비스 이름을 입력하라는 메시지가 표시됩니다.
  • [OPTION]internal 또는 external로 바꿉니다.

기존 서비스 사용 중지

Cloud Run(완전 관리형)은 서비스에서 트래픽 제공을 중지하는 직접적인 방법을 제공하지 않지만, 서비스를 호출하는 ID에 대한 서비스 호출 권한을 취소하여 비슷한 결과를 제공합니다. 특히 서비스가 'public'인 경우 Cloud Run 호출자 역할(roles/run.invoker)에서 allUsers를 삭제합니다.

기존 서비스 삭제

서비스를 삭제하면 트래픽 제공 여부에 관계없이 해당 서비스의 모든 버전을 포함하여 서비스와 관련된 모든 리소스가 삭제됩니다.

서비스를 삭제할 때 삭제된 버전에서 사용되는 컨테이너 이미지는 Container Registry에서 자동으로 삭제되지 않습니다. Container Registry에서 컨테이너 이미지를 삭제하려면 이미지 삭제를 참조하세요.

서비스 삭제는 영구적이므로 실행취소하거나 복원할 수 없습니다. 하지만 서비스를 삭제한 후 동일한 리전에 동일한 이름으로 새 서비스를 배포하면 엔드포인트 URL이 동일하게 지정됩니다.

Console

서비스를 삭제하려면 다음 안내를 따르세요.

  1. Cloud Run으로 이동

  2. 서비스 목록에서 삭제할 서비스를 찾은 다음 체크박스를 클릭하여 선택합니다.

  3. 삭제를 클릭합니다. 이렇게 하면 서비스의 모든 버전이 삭제됩니다.

명령줄

서비스를 삭제하려면 다음 명령어를 사용하세요.

gcloud run services delete [SERVICE]

[SERVICE]를 서비스 이름으로 바꿉니다.