Skip to main content

전달된 포트의 표시 유형 제한

사용자가 조직의 codespace에서 포트를 전달할 때 선택할 수 있는 표시 유형 옵션에 대한 제약 조건을 설정할 수 있습니다.

Who can use this feature

To manage access to port visibility constraints for the repositories in an organization, you must be an owner of the organization.

개요

일반적으로 codespace 내에서 비공개로(자신에게만), 조직의 멤버에게 또는 공개적으로(URL을 가진 모든 사람에게) 포트를 전달할 수 있습니다. 자세한 내용은 “codespace에서 포트 전달”을 참조하세요.

조직 소유자는 포트를 전달할 때 사용자가 설정할 수 있는 표시 유형 옵션에 대한 제약 조건을 구성할 수 있습니다. 예를 들어 보안상의 이유로 퍼블릭 포트 전달을 허용하지 않을 수 있습니다. 이렇게 하려면 조직의 GitHub Codespaces 설정에서 하나 이상의 정책을 정의합니다.

포트 표시 유형 제약 조건을 설정할 때의 동작

정의한 정책을 더 이상 준수하지 않는 기존 codespace가 있는 경우 이러한 codespace는 중지되거나 시간이 초과될 때까지 계속 작동합니다. 사용자가 codespace를 다시 시작하면 정책 제약 조건이 적용됩니다.

참고: 프라이빗 포트 전달은 GitHub Codespaces에서 설계한 대로 계속 작동해야 하므로(예: 포트 22에서 SSH를 전달하기 위해) 프라이빗 포트 전달을 사용하지 않도록 설정할 수 없습니다.

조직 전체 및 리포지토리별 정책 설정

정책을 만들 때 조직의 모든 리포지토리에 적용할지 또는 지정된 리포지토리에만 적용할지 선택합니다. 조직 전체 정책을 설정하는 경우 개별 리포지토리에 대해 설정한 정책은 조직 수준에서 설정된 제한에 속해야 합니다. 정책을 추가하면 표시 유형 옵션이 늘어나거나, 줄어들거나, 제한될 수 있습니다.

예를 들어 표시 유형 옵션을 조직으로만 제한하는 조직 전체 정책을 만들 수 있습니다. 그런 다음, 리포지토리 A에 대해 퍼블릭 및 조직 표시 유형을 모두 허용하지 않는 정책을 설정할 수 있습니다. 그러면 이 리포지토리에 프라이빗 포트 전달만 사용할 수 있습니다. 리포지토리 A에 대해 퍼블릭 및 조직 표시 유형을 모두 허용하는 정책을 설정하면 조직 전체 정책이 퍼블릭 표시 유형을 허용하지 않기 때문에 조직 표시 유형만 적용됩니다.

조직 전체 정책을 추가하는 경우 조직의 모든 리포지토리에 사용할 수 있는 가장 관대한 표시 유형 옵션으로 설정해야 합니다. 그런 다음, 리포지토리별 정책을 추가하여 선택을 추가로 제한할 수 있습니다.

참고: Codespace 정책은 조직의 요금이 청구되는 codespace에만 적용됩니다. 개별 사용자가 조직의 리포지토리에 대한 codespace를 만들었는데 조직에 요금이 청구되지 않는 경우 codespace는 이러한 정책에 의해 바인딩되지 않습니다. 조직에 청구되는 codespace를 만들 수 있는 사용자를 선택하는 방법에 대한 자세한 내용은 “조직에 GitHub Codespaces 사용”을 참조하세요.

포트 표시 유형 옵션을 제한하는 정책 추가

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 클릭한 다음 내 조직을 클릭합니다. 프로필 메뉴의 내 조직 2. 조직 옆에 있는 설정을 클릭합니다. 설정 단추 1. 사이드바의 "코드, 계획 및 자동화" 섹션에서 Codespaces 를 선택한 다음, 정책을 클릭합니다.

  2. "Codespace 정책" 페이지에서 정책 만들기를 클릭합니다.

  3. 새 정책의 이름을 입력합니다.

  4. 제약 조건 추가를 클릭하고 포트 표시 유형을 선택합니다.

    '제약 조건 추가' 드롭다운 메뉴의 스크린샷

  5. 을 클릭하여 제약 조건을 편집합니다.

    제약 조건을 편집하기 위한 연필 아이콘의 스크린샷

  6. 사용할 수 없도록 지정하려는 포트 표시 유형 옵션(조직 또는 퍼블릭)을 선택 취소합니다.

    포트 표시 유형 옵션 지우기의 스크린샷

  7. 대화 상자 바깥쪽을 클릭하여 닫습니다.

  8. 기본적으로 정책은 모든 리포지토리에 적용되도록 설정됩니다. 조직의 일부 리포지토리에만 적용하려면 모든 리포지토리 를 클릭한 다음 드롭다운 메뉴에서 선택한 리포지토리 를 클릭합니다.

    '선택한 리포지토리' 선택 스크린샷

    선택한 리포지토리를 선택한 경우:

    1. 을 클릭합니다.

      설정을 편집하기 위한 기어 아이콘의 스크린샷

    2. 이 정책을 적용할 리포지토리를 선택합니다.

    3. 리포지토리 목록 아래쪽에서 리포지토리 선택을 클릭합니다.

      이 정책에 대해 선택한 리포지토리의 스크린샷

  9. 정책에 다른 제약 조건을 추가하려면 제약 조건 추가를 클릭하고 다른 제약 조건을 선택합니다. 다른 제약 조건에 대한 자세한 내용은 다음을 참조하세요.

  10. 정책에 제약 조건 추가를 완료한 후 저장을 클릭합니다.

정책은 조직에 청구할 수 있는 모든 새 codespace에 적용됩니다. 포트 표시 유형 제약 조건은 다음에 시작할 때 기존 codespace에도 적용됩니다.

정책 편집

기존 정책을 편집할 수 있습니다. 예를 들어 정책에서 제약 조건을 추가하거나 제거할 수 있습니다.

  1. “Codespace 정책” 페이지를 표시합니다. 자세한 내용은 "포트 표시 유형 옵션을 제한하는 정책 추가"를 참조하세요.
  2. 편집할 정책의 이름을 클릭합니다.
  3. "포트 표시 유형" 제약 조건 옆에 있는 연필 아이콘()을 클릭합니다.
  4. 필요에 따라 변경한 다음 저장을 클릭합니다.

정책 삭제

  1. “Codespace 정책” 페이지를 표시합니다. 자세한 내용은 "포트 표시 유형 옵션을 제한하는 정책 추가"를 참조하세요.

  2. 삭제하려는 정책 오른쪽에 있는 삭제 단추를 클릭합니다.

    정책에 대한 삭제 단추의 스크린샷