호스트 프로젝트의 커넥터를 사용하여 공유 VPC 구성

조직에서 공유 VPC를 설정한 경우 공유 VPC 네트워크에 연결할 수 있도록 공유 VPC 서비스 프로젝트에서 다음 설정을 완료하여 서버리스 환경을 사용 설정하세요.

  1. 공유 VPC 호스트 프로젝트의 관리자는 호스트 프로젝트 내에 서버리스 VPC 액세스 커넥터를 만들고 공유 VPC 네트워크에 이를 연결해야 합니다.
  2. 해당하는 경우 호스트 프로젝트 관리자는 호스트 프로젝트에서 서버리스 VPC 액세스 사용자 IAM 역할을 다음 계정에 부여해야 합니다.

    • Cloud Run: 서비스 프로젝트의 Cloud Run 서비스 에이전트(service-SERVICE_PROJECT_NUMBER@serverless-robot-prod.iam.gserviceaccount.com)
    • Cloud Functions: 서비스 프로젝트의 Cloud Functions 서비스 에이전트(service-SERVICE_PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com)
    • App Engine: 서비스 프로젝트에서 App Engine 배포를 수행하는 개인 또는 서비스 계정

    서비스 프로젝트의 서버리스 환경은 이 IAM 역할을 통해 호스트 프로젝트의 커넥터를 사용할 수 있습니다.

    Console

    1. 공유 VPC 호스트 프로젝트의 IAM 페이지로 이동합니다.

      IAM으로 이동

    2. 추가를 클릭합니다.

    3. 새 구성원 필드에 해당 계정의 이메일 주소를 입력합니다(위의 내용 참조).

    4. 역할 필드에서 서버리스 VPC 액세스 사용자를 선택합니다.

    5. 저장을 클릭합니다.

    gcloud

    다음 명령어를 사용하여 공유 VPC 호스트 프로젝트에 대한 권한을 부여합니다.

    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
    --member MEMBER \
    --role roles/vpcaccess.user
    

    여기서 HOST_PROJECT_ID는 공유 VPC 호스트 프로젝트의 ID이고 MEMBER는 적절한 계정의 이메일 주소입니다(위의 내용 참조). 계정 유형에 따라 MEMBER 프리픽스를 user: 또는 serviceAccount:로 사용합니다.

    필요에 따라 여러 계정에 이 과정을 반복합니다.

이 설정이 완료되면 공유 VPC 서비스 프로젝트의 연결된 서버리스 환경은 호스트 프로젝트의 커넥터를 지정하여 플랫폼별 고려사항을 사용해서 공유 VPC 네트워크를 연결할 수 있게 됩니다.

다양한 서버리스 플랫폼의 커넥터 지정

적절한 탭을 사용하여 Cloud Run, App Engine, Cloud Functions의 커넥터를 지정하세요.

Cloud Run

서비스 프로젝트에서 Cloud Run(완전 관리형) 서비스를 배포하거나 업데이트하는 경우 정규화된 이름을 사용하여 호스트 프로젝트의 커넥터를 지정해야 합니다. 예를 들면 다음과 같습니다.

gcloud run deploy SERVICE --image IMAGE_URL \
--vpc-connector projects/HOST_PROJECT_ID/locations/CONNECTOR_REGION/connectors/CONNECTOR_NAME

이렇게 하면 서비스가 공유 VPC 네트워크에 연결됩니다.

App Engine

App Engine 표준의 경우 언어의 VPC 연결 페이지에 설명된 대로 app.yaml 파일에 정규화된 커넥터 이름을 지정합니다(예를 들어 Python 사용).

함수

서비스 프로젝트에 함수를 배포할 때는 커넥터의 정규화된 이름을 사용하여 호스트 프로젝트의 커넥터를 지정해야 합니다.

gcloud functions deploy FUNCTION_NAME \
--vpc-connector projects/HOST_PROJECT_ID/locations/CONNECTOR_REGION/connectors/CONNECTOR_NAME \
FLAGS...

그러면 함수가 공유 VPC 네트워크에 연결됩니다.