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 Code Review Agent를 사용합니다 (미리보기).

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 읽기 요청 실행(예: git clone): Git 프록시 리더 (roles/developerconnect.gitProxyReader)
  • 시스템 연결에 대한 git push와 같은 Git 쓰기 요청 실행: Git 프록시 사용자 (roles/developerconnect.gitProxyUser)
  • 계정 커넥터에 대한 Git 읽기 및 쓰기 요청 실행: 계정 커넥터 OAuth 사용자 (roles/developerconnect.oauthUser)

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

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

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

콘솔

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

    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. 콘솔에서 Developer Connect 를 엽니다. Google Cloud

    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. 콘솔에서 Developer Connect 를 엽니다. Google Cloud

    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)로 바꿉니다.