PyPI 패키지 설치 시 인터넷 액세스 구성

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

이 페이지에서는 사용자 환경에 PyPI 패키지를 설치할 때 인터넷 액세스를 사용 중지하거나 사용 설정하는 방법을 설명합니다.

패키지 설치 및 커스텀 소스(예: VPC 네트워크의 저장소) 구성에 대한 자세한 내용은 Python 종속 항목 설치를 참조하세요.

환경에서 VPC 네트워크에 대한 액세스를 사용 설정하려면 VPC 네트워크에 환경 연결을 참조하세요. 예를 들어 환경에서 VPC 네트워크를 통해 인터넷에 액세스할 수 있도록 VPC 네트워크를 구성할 수 있습니다.

환경을 비공개 IP로 변경하려면 환경 네트워킹 유형(비공개 또는 공개 IP) 변경을 참조하세요.

PyPI 패키지 설치 시 인터넷 액세스 정보

  • 기본적으로 Cloud Composer 3 환경은 PyPI 패키지를 설치할 때 인터넷에 액세스할 수 있습니다.

  • 이제 공개 소스와 비공개 소스 모두에서 패키지를 동시에 설치할 수 있습니다. Cloud Composer 2에서는 불가능했습니다.

  • 이 환경 구성 옵션은 환경의 네트워킹 유형(비공개 또는 공개 IP)과 무관합니다. 예를 들어 비공개 IP 환경의 Python 패키지 색인에서 패키지를 설치할 수 있습니다.

  • 환경을 만들 때 이 구성 옵션을 설정할 수 있으며 기존 환경에서 이 옵션을 변경할 수 있습니다.

PyPI 패키지 설치 시 인터넷 액세스 사용 중지 또는 사용 설정

콘솔

  1. Google Cloud 콘솔에서 환경 페이지로 이동합니다.

    환경으로 이동

  2. 환경 목록에서 환경 이름을 클릭합니다. 환경 세부정보 페이지가 열립니다.

  3. 환경 구성 탭으로 이동합니다.

  4. 네트워크 구성 섹션에서 공개 PyPI 패키지 저장소에 액세스 항목을 찾아 수정을 클릭합니다.

  5. 공개 PyPI 패키지 저장소에 액세스 대화상자에서 다음 안내를 따르세요.

    • 인터넷 액세스를 사용 설정하려면 공개 인터넷 저장소에서 패키지 설치 허용을 선택합니다.

    • 인터넷 액세스를 사용 중지하려면 공개 인터넷 저장소의 패키지 설치 허용 안함을 선택합니다.

  6. 저장을 클릭합니다.

gcloud

다음 Google Cloud CLI 인수는 PyPI 패키지를 설치할 때 인터넷 액세스 구성을 지정합니다.

  • --disable-private-builds-only는 패키지를 설치할 때 인터넷 액세스를 사용 설정합니다(기본값).

  • --enable-private-builds-only는 패키지를 설치할 때 인터넷 액세스를 사용 중지합니다.

패키지를 설치할 때 인터넷 액세스를 사용 설정하려면 다음 Google Cloud CLI 명령어를 실행합니다.

gcloud beta composer environments update ENVIRONMENT_NAME \
  --location LOCATION \
  --disable-private-builds-only

패키지를 설치할 때 인터넷 액세스를 중지하려면 다음 Google Cloud CLI 명령어를 실행합니다.

gcloud beta composer environments update ENVIRONMENT_NAME \
  --location LOCATION \
  --enable-private-builds-only

다음을 바꿉니다.

  • ENVIRONMENT_NAME: 환경의 이름입니다.
  • LOCATION: 환경이 위치한 리전입니다.

예(인터넷 액세스 사용 중지):

gcloud beta composer environments update example-environment \
  --location us-central1 \
  --enable-private-builds-only

API

  1. environments.patch API 요청을 만듭니다.

  2. 이 요청의 작성 방법:

    1. updateMask 매개변수에서 config.private_environment_config.enable_private_builds_only 마스크를 지정합니다.

    2. 요청 본문의 enablePrivateBuildsOnly 필드에 필수 값을 설정합니다.

      • false: PyPI 패키지를 설치할 때 인터넷 액세스를 사용 설정합니다(기본값).
      • true: PyPI 패키지를 설치할 때 인터넷 액세스를 사용 중지합니다.

예(인터넷 액세스 사용 중지):

// PATCH https://composer.googleapis.com/v1beta1/projects/example-project/
// locations/us-central1/environments/example-environment?updateMask=
// config.private_environment_config.enable_private_builds_only

"config": {
  "privateEnvironmentConfig": {
    "enablePrivateBuildsOnly": true
  }
}

Terraform

config 블록의 enable_private_builds_only 필드는 PyPI 패키지를 설치할 때 인터넷 액세스 구성을 지정합니다.

  • false 또는 생략됨: 패키지를 설치할 때 인터넷 액세스를 사용 설정합니다(기본값).

  • true: 패키지를 설치할 때 인터넷 액세스를 사용 중지합니다.

resource "google_composer_environment" "example" {
  provider = google-beta
  name = "ENVIRONMENT_NAME"
  region = "LOCATION"

  config {
    enable_private_builds_only = PRIVATE_BUILDS_MODE
  }
}

다음을 바꿉니다.

  • ENVIRONMENT_NAME: 환경의 이름입니다.
  • LOCATION: 환경이 위치한 리전
  • PRIVATE_BUILDS_MODE: PyPI 패키지를 설치할 때 인터넷 액세스가 사용 중지되는지 여부

예(인터넷 액세스 사용 중지):

resource "google_composer_environment" "example" {
  provider = google-beta
  name = "example-environment"
  region = "us-central1"

  config {

    enable_private_builds_only = true

    ... other configuration parameters

  }

다음 단계