프록시/방화벽 뒤에서 사용할 수 있도록 Cloud SDK 구성

기업 프록시나 방화벽을 사용하는 경우 gcloud 명령줄 도구가 기본 설정으로 인터넷에 액세스하지 못할 수 있습니다.

Cloud SDK 설치

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

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

프록시 구성

SDK를 설치한 후 일반적인 gcloud config 메커니즘을 사용하여 Cloud SDK 속성을 통해 프록시 설정을 구성할 수 있습니다. Cloud SDK 속성과 이 속성 사용 방법에 대한 자세한 내용은 속성 페이지를 참조하세요.

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

gcloud config set proxy/type PROXY_TYPE
gcloud config set proxy/address PROXY_IP_ADDRESS
gcloud config set proxy/port PROXY_PORT
  • Cloud SDK는 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 로그)나 gcloud CLI 구성 파일에 기록하지 않으려면 환경 변수를 사용하여 다음과 같이 속성을 설정하면 됩니다.

export CLOUDSDK_PROXY_USERNAME USERNAME
export CLOUDSDK_PROXY_PASSWORD PASSWORD

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

모든 프록시 관련 속성에 대한 자세한 설명은 여기를 참조하세요.