gcloud CLI를 프록시/방화벽 뒤에서 사용할 수 있도록 구성

기업 프록시나 방화벽 뒤에 있는 경우 Google Cloud CLI가 기본 설정으로 인해 인터넷에 액세스하지 못할 수 있습니다.

gcloud CLI 설치

대화형 gcloud CLI 설치 프로그램은 설치 프로세스의 일부로 인터넷에서 구성요소를 다운로드하므로, 프록시 또는 방화벽을 사용하는 경우 설치 프로그램이 제대로 작동하지 않을 수 있습니다.

프록시 구성이 필요한 경우, 자체 포함된 버전 관리 보관 파일 중 하나를 사용하여 보다 간단하게 gcloud CLI를 설치할 수 있습니다. 다운로드 보관 파일에서 gcloud CLI의 모든 이전 버전도 다운로드할 수 있습니다.

프록시 구성

gcloud CLI를 설치한 후 gcloud config를 실행하면 gcloud CLI 속성을 사용해서 프록시 설정을 구성할 수 있습니다. gcloud CLI 속성은 무엇이고 어떻게 사용하는지에 대한 자세한 내용은 속성 페이지를 참조하세요.

시작하려면 사용 중인 프록시 유형과 여기에 연결하기 위한 주소와 포트를 설정합니다.

gcloud config set proxy/type [PROXY_TYPE]

gcloud config set proxy/address [PROXY_IP_ADDRESS]

gcloud config set proxy/port [PROXY_PORT]
  • gcloud CLI는 PROXY_TYPE에 대해 http, http_no_tunnel, socks4, socks5 값을 지원합니다.
  • PROXY_IP_ADDRESS는 프록시에 연결할 수 있는 호스트 이름 또는 IP 주소입니다.
  • PROXY_PORT는 프록시가 실행 중인 포트입니다(예: 8080).

인증된 프록시의 경우, 다음과 같이 속성을 사용하여 프록시 사용자 이름과 비밀번호를 설정해야 합니다.

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

또는 프록시 사용자 인증 정보를 로그(예: 셸 기록 또는 gcloud CLI 로그)나 gcloud CLI 구성 파일에 기록하지 않기 위해 다음 샘플에 표시된 것처럼 환경 변수를 사용하여 속성을 설정할 수 있습니다.

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

gcloud CLI는 이러한 값을 저장하지 않습니다. 이렇게 하면 사용자 인증 정보를 암호화된 파일에 로컬로 저장하거나 안전한 네트워크 위치에 저장하고 필요할 때 검색할 수 있습니다.

프록시 뒤에 있고 SSL 핸드셰이크 오류가 발생하는 경우 프록시가 커스텀 CA를 사용하는 중간자 프록시일 가능성이 높습니다. 커스텀 CA 파일을 가리키도록 다음 속성을 설정해야 합니다.

gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]

관련 속성에 대한 자세한 설명을 보려면 gcloud topic configurations 또는 gcloud config set를 실행하고 사용 가능한 속성 섹션에서 프록시를 찾습니다.