Developer Connect 프록시 구성 및 사용

이 페이지에서는 Developer Connect 프록시를 구성하는 방법을 설명합니다.

Developer Connect 프록시는 계정 커넥터를 사용하여 소스 코드 관리 시스템 (SCM), 임의 HTTP 엔드포인트 (미리보기), Google 외 개발자 도구 제공업체에 대한 연결에 대한 인증 및 네트워크 액세스를 Developer Connect가 처리하는 방식을 개선합니다 .

시스템 연결 또는 계정 커넥터에 프록시를 사용 설정하면 Developer Connect에서 프록시 서버를 사용하여 git clone와 같은 Git 요청이나 HTTP 엔드포인트에 대한 API 호출을 실행합니다(미리보기).Google Cloud 콘솔을 사용하여 연결을 만들면 프록시가 기본적으로 사용 설정됩니다. 이렇게 하면 Secret Manager에서 액세스 토큰을 관리하는 대신 사용자 또는 서비스 계정에 IAM 권한만 부여하면 됩니다.

예를 들어 연결에서 Developer Connect 프록시를 사용 설정하면 다음 작업을 할 수 있습니다.

  • 온프레미스 네트워크를 비롯한 비공개 호스팅 네트워크에서 SCM과 함께 Gemini Code Assist 코드 맞춤설정을 사용합니다.

  • Google Cloud 인증 및 Identity and Access Management 권한을 사용하여 외부 SCM에서 소스 코드를 클론합니다.

  • 온프레미스 네트워크를 비롯해 비공개 호스팅 네트워크의 SCM과 함께 Gemini 코드 검토 에이전트를 사용합니다 (미리보기).

Developer Connect는 두 가지 유형의 프록시를 지원합니다.

  • 시스템 연결의 프록시

    시스템 연결 프록시에는 다음이 포함됩니다.

    • Git 프록시

    소스 코드 관리 시스템 (SCM) 연결

    임의 HTTP 엔드포인트에 대한 연결

  • 계정 커넥터용 프록시 (미리보기)

    Developer Connect 프록시는 계정 커넥터와 함께 사용할 수 있습니다.

이러한 기능은 모두 동일한 설정을 사용하여 사용 설정됩니다.

시작하기 전에

Developer Connect에 하나 이상의 시스템 연결(GitHub, GitLab, Bitbucket과 같은 SCM 또는 HTTP 엔드포인트에 연결) 또는 계정 커넥터가 있는지 확인합니다.

연결에 대한 Developer Connect 프록시를 구성하는 데 필요한 권한을 얻으려면 관리자에게 Developer Connect 프록시를 사용 설정하거나 중지하는 사용자에게 Developer Connect 관리자 (developerconnect.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

연결을 위해 프록시에 요청을 발행하는 데 필요한 권한을 얻으려면 관리자에게 Git 요청을 발행하는 사용자 계정 또는 서비스 계정에 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 시스템 연결을 위해 git clone와 같은 Git 읽기 요청을 실행합니다. Git 프록시 리더 (roles/developerconnect.gitProxyReader)
  • 시스템 연결을 위해 Git이 git push와 같은 쓰기 요청을 하도록 합니다. Git 프록시 사용자 (roles/developerconnect.gitProxyUser)
  • 계정 커넥터에 대한 Git 읽기 및 쓰기 요청을 합니다. 계정 커넥터 OAuth 사용자 (roles/developerconnect.oauthUser)

시스템 연결의 Developer Connect 프록시 설정 사용 설정 및 사용 중지

Google Cloud 콘솔을 사용하여 시스템 연결을 만들면 프록시가 기본적으로 사용 설정됩니다. 사용 설정하면 Git 프록시와 HTTP 프록시가 모두 사용 설정됩니다.

프록시 설정을 보고 업데이트하려면 다음 단계를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 Developer Connect를 엽니다.

    Developer Connect로 이동

  2. 연결 탭을 클릭한 다음 사용할 연결의 이름을 클릭합니다.

  3. 연결 세부정보 페이지에서 추가 구성 탭을 클릭합니다.

  4. Developer Connect 프록시 전환 버튼을 클릭하여 Developer Connect 프록시 기능을 사용 중지하거나 다시 사용 설정합니다.

    Developer Connect 프록시는 기본적으로 사용 설정되어 있습니다.

Google Cloud CLI

연결에 Developer Connect 프록시 설정 사용 설정

연결에 Developer Connect 프록시를 사용 설정하려면 gcloud developer-connect connections update 명령어를 실행하여 프록시 설정을 사용 설정하세요.

gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--git-proxy-config-enabled

연결의 Developer Connect 프록시 사용 중지

연결의 Developer Connect 프록시를 사용 중지하려면 gcloud developer-connect connections update 명령어를 실행하여 프록시 설정을 사용 중지하세요.

gcloud developer-connect connections update CONNECTION_NAME \
--location=REGION \
--no-git-proxy-config-enabled

연결의 프록시 설정 보기

연결의 Developer Connect 프록시 설정에 대한 세부정보를 보려면 gcloud developer-connect connections describe 명령어를 실행합니다.

gcloud developer-connect connections describe CONNECTION_NAME \
--location=REGION

다음을 바꿉니다.

  • CONNECTION_NAME을 연결 이름으로 바꿉니다.
  • REGION을 연결의 리전으로 바꿉니다.

이 문서의 나머지 부분에는 Git 프록시 관련 안내만 포함되어 있습니다.

계정 커넥터의 Developer Connect 프록시 설정 사용 설정 및 사용 중지

Google Cloud 콘솔을 사용하여 계정 커넥터를 만들면 프록시가 기본적으로 사용 설정됩니다. 사용 설정하면 Git 프록시와 HTTP 프록시가 모두 사용 설정됩니다.

프록시 설정을 보고 업데이트하려면 다음 단계를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 Developer Connect를 엽니다.

    Developer Connect로 이동

  2. 계정 커넥터 탭을 클릭한 다음 사용할 계정 커넥터의 이름을 클릭합니다.

  3. 커넥터 세부정보 페이지에서 구성 탭을 클릭합니다.

  4. Developer Connect 프록시 전환 버튼을 클릭하여 Developer Connect 프록시 기능을 사용 중지하거나 다시 사용 설정합니다.

    Developer Connect 프록시는 기본적으로 사용 설정되어 있습니다.

Google Cloud CLI

계정 커넥터의 Developer Connect 프록시 설정 사용 설정

계정 커넥터에 Developer Connect 프록시를 사용 설정하려면 다음 명령어를 실행하세요.

gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
  --location=REGION \
  --proxy-config-enabled

계정 커넥터의 Developer Connect 프록시 사용 중지

연결의 Developer Connect 프록시를 사용 중지하려면 다음 명령어를 실행합니다.

gcloud alpha developer-connect account-connectors update CONNECTOR_NAME \
  --location=REGION \
  --no-proxy-config-enabled

계정 커넥터의 프록시 설정 보기

연결의 Developer Connect 프록시 설정에 관한 세부정보를 보려면 다음 명령어를 실행하세요.

gcloud alpha developer-connect account-connectors describe CONNECTOR_NAME \
  --location=REGION

다음을 바꿉니다.

  • CONNECTOR_NAME을 계정 커넥터 이름으로 바꿉니다.
  • REGION을 계정 커넥터의 리전으로 바꿉니다.

Git 프록시 URI 찾기

시스템 연결

Developer Connect 프록시가 사용 설정된 경우 다음 단계를 따라 시스템 연결의 Git 프록시 URI를 찾을 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Developer Connect를 엽니다.

    Developer Connect로 이동

  2. 연결 탭을 클릭한 다음 사용할 연결의 이름을 클릭합니다.

  3. 연결 세부정보 페이지에서 저장소 탭을 클릭합니다.

  4. 연결의 저장소를 찾은 다음 Git 프록시 URL 복사를 클릭합니다.

Google Cloud CLI

Git 프록시 URI를 가져오려면 gcloud developer-connect connections git-repository-links describe 명령어를 실행합니다.

gcloud developer-connect connections git-repository-links describe REPOSITORY_NAME \
--connection=CONNECTION_NAME \
--location=REGION

다음을 바꿉니다.

  • REPOSITORY_NAME를 저장소 이름으로 바꿉니다.
  • CONNECTION_NAME을 연결 이름으로 바꿉니다.
  • REGION을 연결의 리전으로 바꿉니다.

Developer Connect API

Git 프록시 URI는 연결의 GitRepositoryLink의 git_proxy_url 필드에 있습니다.

계정 커넥터

Developer Connect 프록시를 사용 설정하면 다음 형식을 사용하여 계정 커넥터의 Git 프록시 URI를 구성할 수 있습니다.

https://REGION-git.developerconnect.dev/a/PROJECT_ID/CONNECTOR_ID/REPO_PATH

각 항목의 의미는 다음과 같습니다.

  • REGION은 계정 커넥터를 만든 리전입니다.

  • PROJECT_ID는 계정 커넥터를 만든 프로젝트의 ID입니다.

  • CONNECTOR_ID은 Git 프록시를 사용 설정한 계정 커넥터의 ID입니다.

  • REPO_PATH은 저장소의 Git URL에서 도메인 뒤에 오는 모든 것입니다.

    예를 들어 저장소 URL이 https://github.com/myusername/test-repo.git이면 REPO_PATH은 myusername/test-repo입니다.

Git 프록시에 요청 문제

Git 프록시 URI가 있으면 다음을 실행하여 Git 프록시에 요청을 발행할 수 있습니다.

  1. Google Cloud CLI 사용자 인증 정보 도우미를 사용하도록 Git CLI를 구성합니다.

    git config --global credential.'https://*.developerconnect.dev'.helper gcloud.sh

  2. Git 프록시에 요청을 실행합니다. 이 예는 git clone 요청입니다.

    계정 커넥터의 경우:

    git clone https://REGION-git.developerconnect.dev/a/PROJECT_NAME/ACCOUNT_CONNECTOR_NAME/ACCOUNT_CONNECTOR_NAME/REPO_PATH

    사용자 인증 정보 도우미를 사용하지 않으려면 대신 요청에 클라우드 액세스 토큰을 삽입하면 됩니다.

    git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/a/PROJECT_NAME/ACCOUNT_CONNECTOR_NAME/REPO_PATH

    시스템 연결의 경우:

    git clone https://REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY_NAME

    사용자 인증 정보 도우미를 사용하지 않으려면 대신 요청에 클라우드 액세스 토큰을 삽입하면 됩니다.

    git clone https://unused:$(gcloud auth print-access-token)@REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY_NAME

    다음을 바꿉니다.

    • REGION을 계정 커넥터의 리전으로 바꿉니다.
    • PROJECT_NAME을 계정 커넥터를 만든 Google Cloud 프로젝트의 이름으로 바꿉니다.
    • ACCOUNT_CONNECTOR_NAME을 계정 커넥터 이름으로 바꿉니다.
    • CONNECTION_NAME을 시스템 연결 이름으로 바꿉니다.
    • REPOSITORY_NAME를 저장소 이름으로 바꿉니다.
    • REPO_PATH을 저장소 경로로 바꿉니다(예: my-org/my-repo).