PlaidCloud Git
PlaidCloud Git은 워크스페이스에 내장된 비공개 Git 서비스입니다. 각 워크스페이스에는 코드, 구성, 노트북 및 그 밖의 버전 관리 파일을 저장하는 전용 Git 서버가 제공되며, 팀이 이를 두고 협업할 때 사용하는 이슈, 풀 리퀘스트, 프로젝트 보드도 함께 제공됩니다.
PlaidCloud 계정으로 로그인하므로 별도의 사용자 이름이나 비밀번호를 설정할 필요가 없습니다. 새 리포지토리는 기본적으로 비공개이며, 액세스 권한을 부여한 멤버에게만 표시됩니다.
Git 열기
섹션 제목: “Git 열기”워크스페이스의 앱 목록에서 Git을 선택합니다. Git 탭에 워크스페이스의 호스트, 사용자의 역할, 리포지토리 목록이 표시됩니다. View all in Git을 사용하면 Git 웹 인터페이스로 이동하고, (그룹을 관리할 수 있는 경우) Manage who can push를 사용하면 그룹 관리가 열리며, 새로 고침 버튼으로 다시 불러올 수 있습니다. ← Back to 워크스페이스 이름 링크를 사용하면 Git에서 PlaidCloud로 돌아갑니다.
역할 표시기에는 Administrator, Contributor, 뷰어 중 현재 수준이 표시되며, 해당 수준에서 할 수 있는 작업을 설명하는 문장이 함께 나타납니다. 각 리포지토리 행에는 이름, 설명(있는 경우), 날짜와 함께 업데이트됨, 복사 버튼이 있는 읽기 전용 복제 필드, 그리고 Git에서 해당 리포지토리를 여는 열기가 표시됩니다. 비공개로 만든 리포지토리는 이 목록이 아니라 Git에서 직접 확인할 수 있습니다.
워크스페이스에 Git이 설정되어 있지 않거나 연결할 수 없으면 Git 탭에 Git is not available과 그 이유가 표시되며, 다시 시도를 선택하면 다시 확인합니다.
리포지토리 복제
섹션 제목: “리포지토리 복제”해당 행에서 리포지토리의 복제 주소를 복사합니다. 처음 복사하면 아래 단계가 담긴 Set up Git on your computer 카드가 나타납니다. 닫기를 선택하면 숨겨지고, 헤더의 How to clone을 선택하면 다시 표시됩니다.
- 컴퓨터에 Git이 설치되어 있어야 합니다.
- Settings → Applications에서 write:repository 권한이 있는 토큰을 만듭니다. 카드에 해당 페이지로 가는 링크가 있습니다.
- 표시된
git config --global user.name및user.email명령 두 개로 Git에 사용자 정보를 알려 줍니다. 이 명령에는 이미 사용자의 이름과 이메일이 들어 있습니다. - 표시된
git clone명령으로 리포지토리를 복제합니다. Git이 비밀번호를 요청하면 PlaidCloud 비밀번호가 아니라 위에서 만든 토큰을 붙여넣습니다.
각 명령에는 자체 복사 버튼이 있습니다. 전체 과정은 리포지토리를 참조하십시오. 복사하려면 푸시 권한과 활성화된 Git 계정이 필요합니다. 복사 버튼이 비활성화되어 있으면 리포지토리를 아무거나 한 번 열어 계정을 활성화하십시오. 뷰어라면 아래 설명에 따라 푸시 권한을 요청하십시오.
액세스 수준
섹션 제목: “액세스 수준”Git 액세스 권한이 있는 모든 사용자는 워크스페이스의 공유 리포지토리를 읽을 수 있습니다. 푸시할 수 있는 수준은 두 가지가 더 있습니다.
| 역할 | 할 수 있는 작업 | 부여 방법 |
|---|---|---|
| 뷰어 | 공유 리포지토리를 보고 복제합니다. | 모든 멤버에게 기본으로 부여됩니다. |
| Contributor | 읽기 권한의 모든 작업과, Panel 및 Dash 앱 코드가 있는 apps 리포지토리에 푸시합니다. |
Git Contributors 보안 그룹입니다. |
| Administrator | Contributor의 모든 작업과, udfs를 포함한 모든 리포지토리에 푸시 및 조직 생성을 수행합니다. |
Git Administration 보안 그룹입니다. |
사용자 정의 함수는 이를 호출하는 워크플로의 ID로 실행되므로 udfs 리포지토리는 관리자에게만 허용됩니다.
뷰어인 경우 Git 탭에 Git Contributors에 추가해 달라고 요청할 수 있는 워크스페이스 관리자가 최대 세 명까지 표시됩니다.
앱과 UDF에서 Git 사용
섹션 제목: “앱과 UDF에서 Git 사용”Panel 또는 Dash 앱 창에는 리포지토리, 브랜치, 빌드 상태를 보여 주는 리포지토리 섹션이 있으며, 푸시할 수 있는 멤버에게는 Edit in browser와 Copy clone URL이 표시됩니다. Panel Studio 앱과 관리형 PlaidCloud Git 연결을 사용하는 App Runner 앱은 apps 리포지토리 안의 폴더이므로 해당 앱 창에 그 리포지토리가 표시됩니다. 앱이 저장되는 위치를 참조하십시오. Git 기반 UDF의 도구 모음에는 Git에서 해당 브랜치의 리포지토리를 여는 열기가 있고, 관리자에게는 Edit in browser가 표시됩니다.
Git 액세스 권한 부여
섹션 제목: “Git 액세스 권한 부여”워크스페이스 관리자는 ID에서 멤버를 보안 그룹에 추가하거나 직접 만든 그룹에 권한을 추가하여 액세스 권한을 부여합니다.
- 앱 코드를 푸시할 수 있게 하려면 멤버를 Git Contributors에 추가하고, Git 관리자로 지정하려면 Git Administration에 추가합니다.
- 모든 신규 멤버에게 앱 코드 푸시 권한을 주려면 Git Contributors를 기본 그룹에 추가합니다. Git Administration은 기본 그룹으로 지정할 수 없습니다.
- 멤버가 할 수 있는 작업을 확인하려면 해당 멤버를 열고 Git 탭을 선택합니다. 멤버의 Git 사용자 이름, 수준, 그리고 그 수준을 부여하는 그룹이 표시됩니다.
변경 사항은 멤버가 다음에 Git에 로그인하거나 Git 탭을 열 때 적용됩니다. 멤버의 Git 계정은 PlaidCloud 멤버십을 따릅니다. 멤버를 비활성화하거나 제거하면 토큰과 SSH 키를 포함한 해당 멤버의 Git 계정이 약 한 시간 안에 차단되고, 다시 활성화하면 차단이 해제됩니다. 삭제되는 것은 없으며 해당 멤버의 리포지토리와 기록은 그대로 유지됩니다. 싱글 사인온으로 Git에 로그인하면 멤버 본인의 계정이 열립니다. PlaidCloud 지원 담당자에게는 관리자 액세스 권한이 자동으로 부여됩니다.
이 섹션의 내용
섹션 제목: “이 섹션의 내용”- 리포지토리 — 리포지토리를 만든 다음 작업 내용을 복제, 커밋, 푸시합니다
- 이슈 — 레이블, 마일스톤, 담당자로 작업, 버그, 아이디어를 추적합니다
- 풀 리퀘스트 — 브랜치에서 변경 사항을 제안하고 병합하기 전에 검토합니다
- 프로젝트 보드 — 칸반 보드에서 이슈와 풀 리퀘스트를 정리합니다
- 릴리스와 태그 — 리포지토리의 버전별 스냅샷을 표시하고 게시합니다
- 위키 — 코드 옆에 장문의 문서를 보관합니다
- 패키지 — 리포지토리 레지스트리에서 빌드 아티팩트를 게시하고 설치합니다
- 코드 검색 — 리포지토리 전반에서 코드, 이슈, 풀 리퀘스트를 찾습니다
관련 문서
섹션 제목: “관련 문서”- PlaidCloud Git에서 Panel 앱 배포 — 자격 증명이 필요 없는 관리형 연결로 HoloViz Panel 앱을 리포지토리에서 바로 제공합니다
- PlaidCloud Git에서 Dash 앱 배포 — Plotly Dash 앱도 같은 방식으로 제공합니다
- 액세스 관리 — 워크스페이스 멤버십과 보안 그룹이 리포지토리를 보고 편집할 수 있는 사용자를 결정하는 방식