Version: 2023.1
언어: 한국어
에셋 스토어 캐시 위치 커스터마이즈
SSH Git URL에 패스프레이즈로 보호되는 SSH 키 사용

HTTPS Git URL로 프라이빗 저장소 사용

터미널에서 Git을 사용하여 HTTPS를 통해 프라이빗 저장소에 액세스하면 사용자 이름과 비밀번호를 입력하라는 프롬프트가 표시됩니다. Git은 이러한 자격 증명을 서버에 제출하며, 서버가 해당 자격 증명을 수락하고 저장소에 대한 액세스를 허용하면 커맨드를 진행합니다.

Unity 패키지 관리자가 Git URL을 사용하여 패키지를 가져올 때는 사용자가 자격 증명을 입력할 수 있는 터미널이 없습니다. 따라서 서버가 Git에서 자격 증명을 요청해도 Git은 프롬프트를 표시하지 않습니다. 대신 Unity 패키지 관리자에 오류를 보고합니다. 이 문제를 해결하려면 Git 자격 증명 헬퍼를 사용하여 Git을 설정해야 하며, 이 헬퍼에는 해당 저장소에 필요한 자격 증명이 이미 로드되어 있어야 합니다. 자격 증명이 유효하면 Git은 Unity 패키지 관리자에서 내린 커맨드를 성공적으로 실행할 수 있습니다.

참고: Git 자격 증명 헬퍼는 SCP 같은 구문을 포함하여 SSH 프로토콜을 통해 Git URL을 사용할 경우 효과가 없습니다.

Git 자격 증명 관리자

Git은 자격 증명을 저장하는 몇몇 자격 증명 헬퍼를 지원하지만, GCM(Git Credential Manager)이 권장되는 자격 증명 헬퍼입니다. GCM은 유연하고 설치하기 쉬우며 적극적으로 지원됩니다. .NET을 기반으로 구축되었기 때문에 .NET을 지원하는 Windows, macOS 및 Linux 배포 버전에서 실행할 수 있습니다.

기본적으로 GCM은 설정된 자격 증명 저장소로서 Windows Credential Manager(Windows)와 macOS Keychain(macOS)을 사용합니다. Linux용으로 설정된 기본 저장소는 GCM에 없습니다. GCM에서 지원되는 다양한 자격 증명 저장소 설정은 GCM 자격 증명 저장소 기술 자료를 참조하십시오.

선행 조건

HTTPS URL을 사용하여 프라이빗 Git 저장소에서 패키지를 가져오려면 GCM을 설치해야 합니다.

Git for Windows 설치 프로그램에는 GCM을 자동으로 설치 및 설정하는 단계가 포함되어 있습니다. 다음과 같은 경우에는 GCM을 별도로 설치할 수도 있습니다.

  • Windows에 Git을 설치하는 다른 메서드를 사용한 경우.
  • macOS 또는 Linux를 사용한 경우.

GCM 설치에 대한 자세한 내용은 GCM 설치 지침을 참조하십시오.

절차

HTTPS Git URL을 사용하는 프라이빗 저장소의 패키지에 액세스하려면 다음 단계를 따르십시오.

  1. 터미널에서 다음 커맨드를 실행하여 Git이 GCM을 사용하도록 설정합니다.

    git config --global credential.helper manager
    
  2. 터미널을 사용하여 저장소에 한 번 액세스합니다. 예를 들어 다음 커맨드를 실행합니다.

    git ls-remote --heads https://<url-to-repository> HEAD
    
  3. Git 프롬프트가 표시되면 자격 증명을 입력합니다. 사용자 계정에 원격 Git 서버에 대한 액세스 권한이 있으며 서버에서 자격 증명을 수락한 경우, Git 자격 증명 헬퍼가 자격 증명을 안전하게 저장합니다.

  4. Unity 패키지 관리자를 사용합니다. 필요한 경우 이는 저장된 자격 증명을 사용하여 액세스 권한이 있는 HTTPS 기반 저장소에서 패키지를 가져옵니다.

에셋 스토어 캐시 위치 커스터마이즈
SSH Git URL에 패스프레이즈로 보호되는 SSH 키 사용