git: 'credential-gcloud.sh' is not a git command. See 'git --help'.
fatal: Authentication failed for [repo-url]
이 문제는 다음과 같은 경우에 발생합니다.
gcloud CLI가 Homebrew 또는 기타 비표준 설치를 사용하여 설치됩니다.
git-credential-gcloud.sh이 PATH에 추가되지 않습니다.
이 문제를 해결하려면 다음 안내를 따르세요.
source $HOMEBREW_PREFIX/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/path.zsh.inc 실행
다음 명령어를 실행하여 git-credential-gcloud.sh가 경로에 있는지 확인합니다.
whichgit-credential-gcloud.sh
권한 거부 또는 승인되지 않음 오류로 인해 Git HTTPS 요청이 실패함
HTTPS를 통해 Git 명령어를 시도하면 권한 거부 또는 승인되지 않음 오류 메시지가 표시됩니다.
이 문제는 다음 중 하나가 발생하는 경우에 발생합니다.
전역 Git 구성 파일에 Secure Source Manager 인증 도우미가 누락되어 있습니다.
새 사용자 인증 정보를 가져오기 위해 Secure Source Manager 인증 도우미를 호출하는 대신 Git의 내장 사용자 인증 정보 저장소가 사용되고 있습니다.
새 사용자 인증 정보를 가져오기 위해 Secure Source Manager 인증 도우미를 호출하는 대신 시스템 사용자 인증 정보 도우미가 사용되고 있습니다.
HTTPS를 사용하여 Secure Source Manager 저장소와 상호작용할 때는 이전 버전의 Google Cloud CLI가 사용됩니다. Secure Source Manager에는 Google Cloud CLI 버전 395.0.0 이상이 필요합니다.
이 문제를 해결하려면 다음 안내를 따르세요.
다음 명령어를 실행하여 전역 Git 구성의 콘텐츠를 확인합니다.
gitconfig--list|grepcredential
macOS에서 *credential*.helper=store와 유사한 행이 표시되거나 Windows OS에서 credential.helper = manager와 유사한 행이 표시되면 해당 행을 삭제한 후 gcloud auth login를 사용하여 다시 인증한 다음 Git 명령어를 다시 시도하세요.
macOS 또는 Linux의 경우 credential.https://*.*.sourcemanager.dev.helper=gcloud.sh, Windows의 경우 credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd가 대답에 포함되지 않으면 전역 Git 구성에 Secure Source Manager 인증 도우미를 추가합니다.
Linux
전역 Git 구성에 Secure Source Manager 인증 도우미를 추가하려면 다음 명령어를 실행합니다.
특정 경계 외부에서 토큰을 사용하지 못하도록 하는 조직 정책(예: 컨텍스트 인식 액세스)이 있습니다.
Secure Source Manager는 기본적으로 컨텍스트 인식 액세스를 지원하지 않습니다. 다음 단계를 진행하려면 지원팀에 문의하세요.
웹 인터페이스 제품 선택기에 프로젝트가 표시되지 않음
Secure Source Manager 웹 인터페이스 제품 선택기를 사용하면 프로젝트가 표시되지 않습니다.
이 문제는 Secure Source Manager의 로그인 사용자 인증 정보가 여러 개인 경우에 발생합니다.
이 문제를 해결하려면 다음 안내를 따르세요.
Secure Source Manager 인스턴스 URL에 다음을 추가하여 쿠키를 삭제합니다.
/_oauth/consent
예를 들어 인스턴스 URL이 https://my-instance-098765432123.us-central1.sourcemanager.dev/인 경우 브라우저 주소 표시줄에 https://my-instance-098765432123.us-central1.sourcemanager.dev/_oauth/consent을 입력한 다음 올바른 사용자 인증 정보로 로그인합니다.
트리거 파일이 빌드를 트리거하지 않음
트리거 파일을 제출한 후 빌드가 예상대로 트리거되지 않으면 다음 문제 중 하나가 있을 수 있습니다.
트리거 파일이 기본 브랜치에 없습니다. 이 문제를 해결하려면 트리거 파일을 기본 브랜치로 이동하세요.
트리거 파일의 형식이 잘못되었습니다. 이 오류는 저장소 페이지에 Build triggers configuration error: ...라는 배너로 표시됩니다.
이 문제를 해결하려면 트리거 파일 스키마를 참고하세요. 트리거 파일 구성이 올바르면 저장소 페이지의 배너에 Valid build triggers configuration가 표시됩니다.
빌드 트리거 구성 오류
triggers.yaml 파일을 Secure Source Manager 저장소에 제출한 후 배너에 다음 오류가 표시됩니다.
Buildcannotbecreated.
이 문제는 다음과 같은 이유로 발생합니다.
Cloud Build 구성 파일에 잘못된 옵션이 있습니다.
Cloud Build 구성 파일의 형식이 잘못되었습니다.
Secure Source Manager 서비스 계정에 사용자 지정 Cloud Build 서비스 계정을 사용하는 데 필요한 권한이 없습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Troubleshoot\n\nThis page shows you how to resolve issues with Secure Source Manager.\n\nError message when creating a repository\n----------------------------------------\n\nThe following error appears when you try to create a repository: \n\n```\nThere was an error while loading /repo/create. Try refreshing the page.\n```\n\nThis issue occurs when:\n\n- The Secure Source Manager API isn't enabled in your project.\n- You don't have the Repo Admin role on your project or permissions to create repositories in the Secure Source Manager instance.\n\nTo resolve this issue:\n\n- [Enable the Secure Source Manager API](/secure-source-manager/docs/enable-disable) in your project.\n- Ask your administrator to grant you the following roles:\n - Repo Admin (`roles/securesourcemanager.repoAdmin`) role on your project.\n - Instance Accessor (`roles/securesourcemanager.instanceAccessor`) on the Secure Source Manager instance.\n - Instance Repository Creator (`roles/securesourcemanager.instanceRepositoryCreator`) on the Secure Source Manager instance.\n\nSee [Access control with IAM](/secure-source-manager/docs/access-control) for more details.\n\nError message when cloning a repository on a Mac\n------------------------------------------------\n\nThe following error appears when you try to clone a repository: \n\n```\ngit: 'credential-gcloud.sh' is not a git command. See 'git --help'.\nfatal: Authentication failed for [repo-url]\n```\n\nThis issue occurs when:\n\n- gcloud CLI is installed using Homebrew or other non-standard installation.\n- `git-credential-gcloud.sh` is not added to your PATH.\n\nTo resolve this issue:\n\n- Run `source $HOMEBREW_PREFIX/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/path.zsh.inc`\n- Check that `git-credential-gcloud.sh` is in your path by running the\n following command:\n\n which git-credential-gcloud.sh\n\nGit HTTPS requests fail with permission denied or unauthorized error\n--------------------------------------------------------------------\n\nWhen Git commands are attempted over HTTPS, a permission denied or unauthorized\nerror message is given.\n\nThis issue occurs when one of the following occurs:\n\n- The global Git config file is missing the Secure Source Manager authentication helper.\n- Git's built-in credential store is being used instead of calling the Secure Source Manager authentication helper to get a fresh credential.\n- A system credential helper is being used instead of calling the Secure Source Manager authentication helper to get a fresh credential.\n- An older version of Google Cloud CLI is used when interacting with Secure Source Manager repositories using HTTPS. Secure Source Manager requires Google Cloud CLI version 395.0.0 or newer.\n\nTo resolve this issue:\n\n1. Run the following command to determine the contents of your global Git\n config.\n\n git config --list | grep credential\n\n2. If you see any line similar to `*credential*.helper=store` on macOS, or\n `credential.helper = manager` on Windows OS, then remove those lines, and\n then re-authenticate using `gcloud auth login` before trying the Git\n command again.\n\n3. If the response doesn't include\n `credential.https://*.*.sourcemanager.dev.helper=gcloud.sh` on macOS or\n Linux, or\n `credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd` on Windows,\n then add the Secure Source Manager authentication helper to your global Git\n config:\n\n ### Linux\n\n 1. To add the Secure Source Manager authentication helper to your global Git\n config, run the following command:\n\n git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh\n\n 2. Validate that the authentication helper line is added to your global Git\n config by running the following command:\n\n git config --list | grep credential\n\n The output should include\n `credential.https://*.*.sourcemanager.dev.helper=gcloud.sh`.\n 3. Authenticate by running `gcloud auth login`.\n\n 4. Run a Git command to test the authentication.\n\n ### Windows\n\n 1. Check your gcloud CLI version by following the [Install Git\n and Google Cloud CLI](/secure-source-manager/docs/use-git#install_git_and) instructions.\n 2. To add the Secure Source Manager authentication helper to your global Git\n config, run the following command:\n\n git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd\n\n 3. Validate that the authentication helper line is added to your global Git\n config by running the following command:\n\n git config --list | grep credential\n\n The output should include\n `credential.https://*.*.sourcemanager.dev.helper=gcloud.cmd`.\n 4. Authenticate by running `gcloud auth login`.\n\n 5. Run a Git command to test the authentication.\n\nProject not showing up in web interface product selector\n--------------------------------------------------------\n\nWhen using the Secure Source Manager web interface product selector, your\nproject doesn't appear.\n\nThis issue occurs when you have multiple login credentials for\nSecure Source Manager.\n\nTo resolve this issue:\n\n- Clear your cookies by appending the following to your Secure Source Manager\n instance URL:\n `/_oauth/consent`\n\n For example, if your instance URL is\n `https://my-instance-098765432123.us-central1.sourcemanager.dev/`, enter\n `https://my-instance-098765432123.us-central1.sourcemanager.dev/_oauth/consent`\n into your browser address bar and then sign in with the correct credentials.\n\nTriggers file doesn't trigger builds\n------------------------------------\n\nIf builds aren't triggered as expected after submitting your triggers file, you\nmight have one of the following problems:\n\n- The triggers file isn't in the default branch. To resolve this, move your triggers file to your default branch.\n- The triggers file has an invalid format. This error is indicated by a banner in the repository page that reads `Build triggers configuration error: ...`. To fix this, read the [Triggers file schema](/secure-source-manager/docs/triggers-file-schema). When the triggers file configuration is correct, the banner in the repository page reads `Valid build triggers configuration`.\n\nBuild triggers configuration error\n----------------------------------\n\nAfter submitting your `triggers.yaml` file to your Secure Source Manager\nrepository you get the following error displayed in a banner: \n\n Build cannot be created.\n\nThis issue occurs for the following reasons:\n\n- The Cloud Build configuration file has invalid options.\n- The Cloud Build configuration file has an invalid format.\n- The Secure Source Manager service account doesn't have the required permissions to use the user-specified Cloud Build service account.\n\nTo fix this issue:\n\n- Make sure you're following the correct [Triggers file schema](/secure-source-manager/docs/triggers-file-schema).\n- Make sure that the Secure Source Manager service account and the Cloud Build service account have sufficient permissions. To view the required permissions, see [Required service account roles](/secure-source-manager/docs/connect-cloud-build#required-sa-roles).\n\nBuild fails during execution\n----------------------------\n\nIf a build is triggered successfully, but fails during execution, the associated\ncommit has a Failure commit status.\n\nTo troubleshoot a failed build, in the repository page, next to the failed\ncommit status, click **Details**.\n\nThe Cloud Build execution log opens. For more information on troubleshooting\nbuilds in Cloud Build, see\n[Troubleshooting build errors](/build/docs/troubleshooting)."]]
