리포지토리를 패키지에 연결

GitHub의 패키지에 리포지토리를 연결할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Enterprise Managed Users는 조직 네임스페이스에 게시할 수 있습니다. 해당되는 사용자는 개인 스토리지 할당이 없으므로 해당 계정의 네임스페이스에 패키지를 게시할 수 없습니다. Enterprise Managed Users에 대한 정보는 Enterprise Managed Users 정보을(를) 참조하세요.

이 기사에서

개인 계정 또는 조직으로 범위가 지정된 패키지를 게시하는 경우 패키지가 기본적으로 리포지토리에 연결되지 않습니다. 패키지를 리포지토리에 연결하면 패키지의 방문 페이지에 README와 같은 리포지토리의 정보와 링크가 표시됩니다. 패키지가 연결된 리포지토리에서 액세스 권한을 상속하도록 선택할 수도 있습니다. 자세한 내용은 패키지의 액세스 제어 및 표시 여부 구성을(를) 참조하세요.

GitHub에서 리포지토리를 사용자 범위 패키지에 연결

  1. GitHub에서 개인 계정의 기본 페이지로 이동합니다.

  2. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your profile을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "프로필"은 진한 주황색으로 표시됩니다.

  3. 프로필 페이지의 헤더에서 패키지 탭을 클릭합니다.

    1. GitHub에서 개인 계정의 기본 페이지로 이동합니다.

  5. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your profile을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "프로필"은 진한 주황색으로 표시됩니다.

  6. 프로필 페이지의 헤더에서 패키지 탭을 클릭합니다.

  7. 패키지 버전 아래에 있는 리포지토리 연결을 클릭합니다.

  8. 패키지에 연결할 리포지토리를 선택한 다음 리포지토리 연결을 클릭합니다.

관리하려는 패키지의 이름을 검색한 후 그 이름을 클릭합니다.

  1. GitHub에서 조직의 기본 페이지로 이동합니다.

  2. 조직 이름에서 패키지 탭을 클릭합니다.

    @octo-org의 프로필 페이지 스크린샷. "패키지" 탭이 주황색 윤곽선으로 강조 표시됩니다.

    1. 패키지 버전 아래에 있는 리포지토리 연결을 클릭합니다.

  4. 패키지에 연결할 리포지토리를 선택한 다음 리포지토리 연결을 클릭합니다.

  5. 패키지 버전 아래에 있는 리포지토리 연결을 클릭합니다.

  6. 패키지에 연결할 리포지토리를 선택한 다음 리포지토리 연결을 클릭합니다.

GitHub에서 리포지토리를 조직 단위의 패키지에 연결

참고

리포지토리에 연결된 패키지를 게시하는 경우, 패키지는 자동으로 연결된 리포지토리의 액세스 권한을 상속받고, 조직에서 액세스 권한의 자동 상속을 사용하지 않도록 설정하지 않은 한 연결된 리포지토리의 GitHub Actions 워크플로에 패키지에 대한 액세스 권한이 자동으로 부여됩니다. 자세한 내용은 패키지의 액세스 제어 및 표시 여부 구성을(를) 참조하세요.

  1. ghcr.io

    LABEL org.opencontainers.image.source=https://github.com/OWNER/REPO

    관리하려는 패키지의 이름을 검색한 후 그 이름을 클릭합니다.

    LABEL org.opencontainers.image.source=https://github.com/octocat/my-repo
    1. 패키지 버전 아래에 있는 리포지토리 연결을 클릭합니다.
    2. 패키지에 연결할 리포지토리를 선택한 다음 리포지토리 연결을 클릭합니다.

  2. 명령줄을 사용하여 리포지토리를 컨테이너 이미지에 연결

참고

리포지토리에 연결된 패키지를 게시하는 경우, 패키지는 자동으로 연결된 리포지토리의 액세스 권한을 상속받고, 조직에서 액세스 권한의 자동 상속을 사용하지 않도록 설정하지 않은 한 연결된 리포지토리의 GitHub Actions 워크플로에 패키지에 대한 액세스 권한이 자동으로 부여됩니다. 자세한 내용은 패키지의 액세스 제어 및 표시 여부 구성을(를) 참조하세요.

docker build -t hello_docker .

$ docker images
> REPOSITORY          TAG         IMAGE ID       CREATED         SIZE
> hello_docker        latest      142e665b1faa   5 seconds ago   125MB
> redis               latest      afb5e116cac0   3 months ago    111MB
> alpine              latest      a6215f271958   5 months ago    5.29MB

  1. Dockerfile에서 이 줄을 추가하고 OWNER와 REPO를 사용자 세부 정보로 바꿉니다.

    docker tag IMAGE_NAME ghcr.io/NAMESPACE/NEW_IMAGE_NAME:TAG

    예를 들어, 사용자 명이 octocat, my-repo 다음과 같은 라인을 Dockerfile에 추가해야 합니다.

    자세한 내용은 공식 Docker 설명서의 레이블 및 사전 정의된 주석 키를 opencontainers/image-spec 리포지토리에서 참조하세요.

    docker tag 38f737a91f39 ghcr.io/octocat/hello_docker:latest

  2. 컨테이너 이미지를 빌드합니다. 다음은 현재 디렉터리의 Dockerfile에서 이미지를 빌드하고 이미지 이름 hello_docker를 할당하는 예시입니다.

    $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
> Login Succeeded

  3. 원하는 경우 방금 만든 Docker 이미지의 세부 정보를 검토합니다.

    docker push ghcr.io/NAMESPACE/IMAGE-NAME:TAG

    Docker 이미지에 이름 및 호스팅 대상을 할당합니다.

    docker push ghcr.io/octocat/hello_docker:latest


          `NAMESPACE`를 패키지의 범위로 지정할 개인 계정 또는 조직의 이름으로 바꿉니다.

참고

예시: 아직 인증하지 않은 경우 Container registry에 인증합니다. 자세한 내용은 컨테이너 레지스트리 작업을(를) 참조하세요.

  1. {원시 데이터}

컨테이너 이미지를 Container registry에 푸시합니다.

  1. 예시:

GitHub의 패키지에서 리포지토리 연결 해제 리포지토리에서 패키지를 연결 해제하면 패키지 방문 페이지에서 리포지토리 정보가 제거되고 패키지가 리포지토리에서 액세스 권한을 상속하는지 여부에 따라 액세스 패턴에 영향을 줄 수 있습니다. 자세한 내용은 패키지의 액세스 제어 및 표시 여부 구성을(를) 참조하세요.

  1. 이 동작은 GitHub 패키지에 대한 사용 권한 정보에 설명된 대로 Apache Maven 패키지에는 적용되지 않습니다.

GitHub에서 연결을 해제하려는 패키지의 설정 페이지로 이동합니다.

패키지 설정 페이지에 리포지토리 원본 섹션이 표시됩니다.

  1. 이 섹션이 없으면 패키지가 현재 리포지토리에 연결되지 않습니다.
  2. 리포지토리 원본 섹션의 오른쪽 위 모서리에 있는 휴지통 아이콘을 클릭합니다.