이 페이지에서는 Developer Connect 프록시를 구성하는 방법을 설명합니다.
Developer Connect 프록시는 Developer Connect가 소스 코드 관리 시스템 (SCM) 및 임의 HTTP 엔드포인트에 대한 인증 및 네트워크 액세스를 처리하는 방식을 개선합니다 (미리보기). 연결에 프록시를 사용 설정하면 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 프록시 (미리보기)
임의 HTTP 엔드포인트에 대한 연결
이 두 구성요소는 동일한 설정을 사용하여 사용 설정됩니다. Git 프록시를 사용하면 사용량을 더 효과적으로 관리할 수 있습니다.
시작하기 전에
Developer Connect에서 GitHub, GitLab, Bitbucket과 같은 SCM에 연결이 하나 이상 있는지 확인합니다.
연결에 대한 Developer Connect 프록시를 구성하는 데 필요한 권한을 얻으려면 관리자에게 Developer Connect 프록시를 사용 설정하거나 중지하는 사용자에 대한 Developer Connect 관리자 (developerconnect.admin) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
연결을 위해 프록시에 요청을 발행하는 데 필요한 권한을 얻으려면 관리자에게 Git 요청을 발행하는 사용자 계정 또는 서비스 계정에 다음 IAM 역할을 부여해 달라고 요청하세요.
-
Git이
git clone와 같은 읽기 요청을 수행하도록 합니다. Git 프록시 리더 (roles/developerconnect.gitProxyReader) -
Git이
git push와 같은 쓰기 요청을 하도록 합니다. Git 프록시 사용자 (roles/developerconnect.gitProxyUser)
Developer Connect 프록시 설정 보기 및 업데이트
Developer Connect 프록시는 기본적으로 사용 설정되어 있습니다. 사용 설정하면 Git 프록시와 HTTP 프록시가 모두 사용 설정됩니다.
프록시 설정을 보고 업데이트하려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 Developer Connect를 엽니다.
연결 탭을 클릭한 다음 사용할 연결의 이름을 클릭합니다.
연결 세부정보 페이지에서 추가 구성 탭을 클릭합니다.
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 프록시 관련 안내만 포함되어 있습니다.
Git 프록시 URI 찾기
Developer Connect 프록시가 사용 설정된 경우 다음 단계를 따라 연결의 Git 프록시 URI를 찾을 수 있습니다.
콘솔
Google Cloud 콘솔에서 Developer Connect를 엽니다.
연결 탭을 클릭한 다음 사용할 연결의 이름을 클릭합니다.
연결 세부정보 페이지에서 저장소 탭을 클릭합니다.
연결의 저장소를 찾은 다음 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 필드에 있습니다.
Git 프록시에 요청 발행
Git 프록시 URI가 있으면 다음을 실행하여 Git 프록시에 요청을 발행할 수 있습니다.
Google Cloud CLI 사용자 인증 정보 도우미를 사용하도록 Git CLI를 구성합니다.
git config --global credential.'https://*.developerconnect.dev'.helper gcloud.shGit 프록시에
git clone와 같은 요청을 실행합니다.git clone https://REGION.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY NAME사용자 인증 정보 도우미를 사용하지 않으려면 대신 요청에 클라우드 액세스 토큰을 삽입하면 됩니다.
git clone https://unused:$(gcloud auth print-access-token)@REGION-git.developerconnect.dev/PROJECT_NAME/CONNECTION_NAME/REPOSITORY NAME다음을 바꿉니다.
- REPOSITORY_NAME를 저장소 이름으로 바꿉니다.
- CONNECTION_NAME을 연결 이름으로 바꿉니다.
- REGION을 연결의 리전으로 바꿉니다.