Git 소스 컨트롤 설정하기

R2025a 이후. 다음을 대체: Set Up Git Source Control (R2024b).

MATLAB®에서 Git™ 소스 컨트롤을 사용하여 파일을 관리하고 다른 사용자와 협업할 수 있습니다. Git을 사용하면 파일의 변경 사항을 추적하고 나중에 특정 버전을 다시 불러올 수 있습니다. 자세한 내용은 Track Work Locally with Git in MATLAB 항목과 Collaborate Using Git in MATLAB 항목을 참조하십시오.

Git을 사용하기에 앞서 다음 단계에 따라 MATLAB에 대해 Git을 설정하십시오.

R2024a부터는 MATLAB 내에서 Git 후크를 실행할 수 있습니다. 지원되는 후크는 pre-commit, commit-msg, post-commit, prepare-commit-msg, pre-push, pre-merge-commit, post-checkout, post-merge입니다. 예제는 Use Git Hooks in MATLAB 항목을 참조하십시오.

Git에 이진 파일 등록하기

타사 소스 컨트롤 툴을 사용하는 경우, .mlx, .mat, .fig, .mlapp, .mdl, .slx, .mdlp, .slxp, .sldd 및 .p와 같은 MATLAB 및 Simulink® 파일 확장자를 이진 형식으로 등록해야 합니다. 또한 .mexa64, .mexmaci64, .mexmaca64, .mexw64와 같은 MEX 파일의 확장자도 등록합니다. 확장자를 등록하지 않으면, 라인 끝(EOL) 문자 변경, 토큰 확장, 키워드 대체, 또는 자동 병합 시도 등을 통해 파일을 제출할 때 이러한 툴이 파일을 손상시킬 수 있습니다. MATLAB 외부에서 소스 컨트롤 툴을 사용하는 경우나 먼저 파일 형식을 등록하지 않은 채로 MATLAB에서 파일을 제출하려고 하는 경우에 손상이 발생할 수 있습니다.

또한 체크인 작업 중 손상을 방지하기 위해 .xlsx, .jpg, .pdf 및 .docx와 같은 다른 파일 확장자도 이진 형식으로 등록합니다.

Git에 이진 파일 확장자를 등록하려면 리포지토리의 .gitattributes 파일에 확장자를 추가하십시오. Git 소스 컨트롤을 사용하는 새 프로젝트를 만들거나 다른 소스 컨트롤 시스템에 있는 기존 프로젝트를 Git 소스 컨트롤로 전환하는 경우 MATLAB은 자동으로 .gitattributes 파일을 만들어서 등록할 일반적인 이진 파일 목록으로 채웁니다.

.gitattributes 파일이 자동으로 생성되지 않으면 이 파일에 등록할 일반적인 이진 파일 목록을 포함시켜 직접 만들 수 있습니다. MATLAB 명령 창에 다음을 입력합니다.

copyfile(fullfile(matlabroot,'toolbox','shared','cmlink','git','auxiliary_files', ...
'mwgitattributes'),fullfile(pwd,'.gitattributes'))

또는 리포지토리에 비어 있는 .gitattributes 파일을 만들고 내용을 채웁니다.

  1. .gitattributes 파일 맨 위에 * text=auto를 추가합니다.

  2. 각 이진 파일 확장자 ext에 대해 *.ext binary를 추가합니다. 예를 들면 *.mlapp binary와 같습니다.

긴 경로에 대한 지원 활성화하기

다음 단계에 따라 Windows 시스템에서 긴 경로를 사용할 수 있도록 설정하십시오.

  1. 홈 탭의 환경 섹션에서 설정을 클릭합니다. MATLAB > 소스 컨트롤 > Git을 선택합니다.

  2. Windows 섹션에서 긴 경로에 대한 지원 활성화를 선택합니다. 이렇게 하면 전역 Git 구성 파일에서 core.longpaths의 값이 true로 설정됩니다.

자세한 내용은 Git 설정 구성하기 항목을 참조하십시오.

커밋 서명 활성화하기

다음 단계에 따라 MATLAB이 Git 커밋에 자동으로 서명할 수 있도록 소스 컨트롤 설정을 구성하십시오. MATLAB이 커밋 시그니처를 검증하면 브랜치 관리자와 MATLAB 편집기의 라인 주석 모두에서 아바타와 사용자 이름 옆에 녹색 검증 아이콘 이 나타납니다.

  1. 홈 탭의 환경 섹션에서 설정을 클릭합니다. MATLAB > 소스 컨트롤 > Git을 선택합니다.

  2. 커밋 서명 섹션에서 서명 키, 서명 키 형식, 서명 프로그램을 설정합니다. 자세한 내용은 Git 설정 구성하기 항목을 참조하십시오.

Git SSH 인증을 사용하도록 MATLAB 구성하기

HTTPS를 사용하여 원격 리포지토리와 상호 작용할 때 잦은 로그인 프롬프트를 방지하려면 SSH를 대신 사용하여 새 공개 키를 추가하고 리포지토리를 복제하십시오. 다음 단계에 따라 SSH 인증을 사용하도록 MATLAB을 구성하십시오.

  1. ssh-keygen 명령을 사용하여 SSH 키를 생성합니다. 예를 들어, 명령 프롬프트에 다음 명령을 입력합니다.

    ssh-keygen -t ed25519 -C "your_email@example.com"
    ssh-keygen이 키를 저장할 위치를 확인하고 암호를 묻습니다. 키를 사용할 때 비밀번호를 입력하고 싶지 않으면 암호를 빈 상태로 두십시오.

    지정된 폴더에 이미 키가 있는 경우 ssh-keygen은 키를 재정의할지 묻습니다.

  2. MATLAB에서 SSH 키를 사용하도록 설정합니다. 홈 탭의 환경 섹션에서 설정을 클릭합니다. MATLAB > 소스 컨트롤 > Git을 선택합니다. 그런 다음 설정을 구성합니다.

    1. SSH 섹션에서, 활성화되어 있지 않으면 SSH 활성화를 선택합니다.

      기본적으로 MATLAB은 SSH 에이전트에서 키를 찾습니다. Windows에서는 OpenSSH를 SSH 에이전트로 사용합니다. 자세한 내용은 Key-based authentication in OpenSSH for Windows 항목을 참조하십시오.

      SSH 에이전트를 사용하면 여러 개의 키를 저장하고 사용할 수 있습니다.

    2. 키를 저장하기 위해 SSH 에이전트를 사용하지 않는 경우 수동으로 키를 입력할 수 있습니다. SSH 에이전트 사용 체크박스를 선택 해제합니다. 그런 다음 공개 키 파일 및 개인 키 파일에 공개 키 파일과 개인 키 파일의 경로를 지정합니다. 자세한 내용은 Git 설정 구성하기 항목을 참조하십시오.

      암호를 사용하도록 설정하고 세션마다 프롬프트를 한 번 수신하려면 키가 암호로 보호됨을 선택합니다.

  3. SSH 키를 사용하도록 GitHub® 또는 GitLab® 계정을 구성합니다. 이렇게 하려면 .ssh 폴더로 이동하여 .pub 파일의 내용을 복사하십시오. 그런 다음 계정 설정으로 이동하여 SSH keys 섹션에서 Add SSH key 필드에 .pub 파일 내용을 붙여 넣습니다.

Git 자격 증명 관리하기

기본적으로 MATLAB은 사용자가 Git 리포지토리와 상호 작용할 때 사용자 이름과 토큰을 기억합니다. 디폴트 자격 증명 기본 설정을 변경하려면 홈 탭의 환경 섹션에서 설정을 클릭하십시오. MATLAB > 소스 컨트롤 > Git을 선택합니다. 자격 증명 섹션에서 사용 가능한 옵션 중 하나를 선택합니다. 자세한 내용은 Git 설정 구성하기 항목을 참조하십시오.

또는 사용자가 외부 Git 자격 증명 헬퍼를 설치하여 이것을 대신 사용하도록 MATLAB을 구성할 수 있습니다. 모든 플랫폼에 권장하는 자격 증명 헬퍼는 Git Credential Manager Core입니다. 자세한 내용은 추가 설정의 Git 자격 증명 헬퍼를 사용하도록 MATLAB 구성하기를 참조하십시오.

Git 리포지토리에 대해 저장된 로그인 정보를 삭제하려면 MATLAB에서 다음을 입력하십시오.

matlab.git.clearCredential("https://github.com/myrepo.git")

Git LFS를 사용하도록 Git 구성하기

용량이 큰 파일을 사용하여 작업하는 경우 커맨드 라인 Git을 설치하고 LFS(Large File Storage)를 설정하여 Git LFS를 사용하도록 Git을 구성합니다.

예를 들어, Windows 시스템에서 Git LFS를 사용하려면 추가 설정의 커맨드 라인 Git 클라이언트 설치하기에 설명된 지침에 따라 Windows용 Git 인스톨러를 다운로드하여 실행하십시오. Windows용 Git 인스톨러의 Select Components 섹션에서 Git LFS (Large File Support) 및 Associate .sh files to be run with Bash 옵션을 선택합니다.

추가 설정

  • Git LFS 또는 자격 증명 헬퍼를 사용하려면 커맨드 라인 Git 클라이언트를 설치하고 시스템 전체에서 사용할 수 있도록 하십시오.

     커맨드 라인 Git 클라이언트 설치하기

  • MATLAB은 사용자가 Git 리포지토리와 상호 작용할 때 사용자 이름과 토큰을 기억합니다. 외부 Git 자격 증명 헬퍼를 사용하여 Git 자격 증명을 대신 저장할 수 있습니다. Git Credential Manager Core는 모든 플랫폼에 권장하는 자격 증명 헬퍼입니다.

     Git 자격 증명 헬퍼를 사용하도록 MATLAB 구성하기

참고 항목

함수

도움말 항목