Skip to main content

GitHub Codespaces에 대한 계정별 비밀 관리

환경 변수를 통해 Codespace에 액세스하려는 토큰 등의 중요한 정보를 저장할 수 있습니다.

GitHub Codespaces에 대한 비밀 정보

Codespace에서 사용하려는 개인 계정에 개발 환경 비밀을 추가할 수 있습니다. 예를 들어 다음과 같은 중요한 정보를 비밀로 저장하고 액세스하려고 할 수 있습니다.

각 비밀에 액세스할 수 있는 리포지토리를 선택할 수 있습니다. 그런 다음, 비밀에 대한 액세스 권한이 있는 리포지토리에 대해 만든 모든 codespace에서 비밀을 사용할 수 있습니다. 템플릿에서 만든 codespace와 비밀을 공유하려면 GitHub의 리포지토리에 codespace를 게시한 다음 해당 리포지토리에 비밀에 대한 액세스 권한을 부여해야 합니다.

비밀은 비밀을 만든 후 새 codespace를 만들거나 codespace를 다시 시작할 때 사용할 수 있습니다. GitHub.com에 비밀을 만들고 현재 실행 중인 codespace에서 비밀을 사용하려면 codespace를 중지한 다음 다시 시작합니다. codespace를 중지하는 방법에 대한 자세한 내용은 "Github Codespaces에서 Visual Studio Code 명령 팔레트 사용"을(를) 참조하세요.

비밀 이름 지정

비밀 이름에는 다음 규칙이 적용됩니다.

  • 비밀 이름은 영숫자 문자([a-z], [A-Z], [0-9]) 또는 밑줄(_)만 포함할 수 있습니다. 공백은 사용할 수 없습니다.
  • 비밀 이름은 GITHUB_ 접두사로 시작해서는 안됩니다.
  • 비밀 이름은 숫자로 시작해서는 안됩니다.
  • 비밀 이름은 대/소문자를 구분하지 않습니다.
  • 비밀 이름은 만든 수준에서 고유해야 합니다. 예를 들어 리포지토리 수준에서 만든 비밀에는 해당 리포지토리에 고유한 이름이 있어야 합니다.

이름이 같은 비밀이 여러 수준에 있는 경우 가장 낮은 수준의 비밀이 우선적으로 적용됩니다. 예를 들어 조직 수준 비밀의 이름이 리포지토리 수준 비밀과 동일한 경우 리포지토리 수준 비밀이 우선 적용됩니다.

비밀에 대한 제한

GitHub Codespaces에 최대 100개의 비밀을 저장할 수 있습니다.

비밀의 크기는 48KB로 제한됩니다.

비밀 추가

  1. 페이지의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 설정 클릭합니다.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. 사이드바의 "코드, 계획, 자동화" 섹션에서 Codespaces를 클릭합니다.

  3. “Codespaces 비밀” 오른쪽에서 새 비밀을 클릭합니다.

  4. “이름”에서 비밀의 이름을 입력합니다.

  5. "값" 아래에 비밀 값을 입력합니다.

  6. “Repository access”(리포지토리 액세스) 드롭다운 메뉴를 선택한 다음 비밀에 액세스할 리포지토리를 클릭합니다. 비밀에 액세스하려는 모든 리포지토리에 대해 반복합니다.

    "리포지토리 액세스" 드롭다운 메뉴의 스크린샷 드롭다운 메뉴에 두 개의 리포지토리가 나열됩니다.

  7. 비밀 추가를 클릭합니다.

비밀 편집

기존 비밀의 값을 업데이트할 수 있으며 비밀에 액세스할 수 있는 리포지토리를 변경할 수 있습니다.

  1. 페이지의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 설정 클릭합니다.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. 사이드바의 "코드, 계획, 자동화" 섹션에서 Codespaces를 클릭합니다.

  3. “Codespaces 비밀”에서 편집할 비밀의 오른쪽에 있는 업데이트를 클릭합니다.

  4. “값”에서 새 값을 입력 링크를 클릭합니다.

    "Codespaces / 비밀 업데이트" 페이지의 스크린샷. "새 값 입력" 링크는 진한 주황색 윤곽선으로 강조 표시됩니다.

  5. "값" 아래에 비밀 값을 입력합니다.

  6. “Repository access”(리포지토리 액세스) 드롭다운 메뉴를 선택한 다음 비밀에 액세스할 리포지토리를 클릭합니다. 비밀에 액세스하려는 모든 리포지토리에 대해 반복합니다.

    "리포지토리 액세스" 드롭다운 메뉴의 스크린샷 드롭다운 메뉴에 두 개의 리포지토리가 나열됩니다.

  7. 필요에 따라 리포지토리에 대한 비밀의 액세스를 제거하려면 리포지토리의 선택을 취소합니다.

    두 리포지토리 목록을 보여 주는 스크린샷입니다. 각 확인란이 선택되어 있습니다.

  8. 변경 내용 저장을 클릭합니다.

비밀 삭제

  1. 페이지의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 설정 클릭합니다.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. 사이드바의 "코드, 계획, 자동화" 섹션에서 Codespaces를 클릭합니다.

  3. “Codespaces 비밀”에서 삭제할 비밀의 오른쪽에 있는 삭제를 클릭합니다.

  4. 경고를 읽은 다음 확인을 클릭합니다.

비밀 사용

개발 환경 비밀은 환경 변수로 사용자의 터미널 세션으로 내보내집니다.

VS Code.의 터미널 스크린샷입니다. "echo $EXAMPLE_API_KEY" 명령이 "aBCdeFG1234567"을 반환했습니다.

Codespace가 빌드되고 실행되고 나면 개발 환경 비밀을 사용할 수 있습니다. 예를 들어 다음과 같은 경우에 비밀을 사용할 수 있습니다.

  • 통합 터미널 또는 ssh 세션에서 애플리케이션을 시작할 때.
  • codespace가 실행된 후 실행되는 개발 컨테이너 수명 주기 스크립트 내에서. 개발 컨테이너 수명 주기 스크립트에 대한 자세한 내용은 개발 컨테이너 웹사이트: 사양 설명서를 참조하세요.

다음의 경우 개발 환경 비밀은 사용할 수 없습니다.

  • Codespace 빌드 시간 동안(즉, Dockerfile 또는 사용자 지정 진입점 내).
  • 개발 컨테이너 기능 내에서. 자세한 내용은 개발 컨테이너 웹 사이트의 개발 컨테이너 사양 에 있는 features 속성을 참조하세요.

추가 참고 자료