Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Configurando o controle de acesso e visibilidade de um pacote

Escolha quem tem acesso de leitura, gravação ou administrador à sua imagem de contêiner e a visibilidade das suas imagens de contêiner em GitHub.

O GitHub Packages está disponível com GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server 3.0 ou superior e o GitHub AE.
O GitHub Packages não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. Além disso, as contas que usam os planos de legado por repositório não podem acessar o Container registry já que essas contas são cobradas por repositório. Para obter mais informações, confira "produtos de GitHub".

Pacotes com permissões granulares são escopos para uma conta de usuário pessoal ou de organização. Você pode alterar o controle de acesso e a visibilidade de um pacote separadamente do repositório ao qual ele está conectado (ou vinculado).

Alguns registros suportam apenas permissões com escopo de repositório. Para obter a lista desses registros, confira "Sobre permissões para o GitHub Packages".

Para obter mais informações sobre permissões para pacotes, escopos relacionados a pacotes para PATs ou gerenciamento de permissões para seus fluxos de trabalho de ações, confira "Sobre permissões para pacotes GitHub".

Visibilidade e permissões de acesso para imagens de contêiner

Se você tiver permissões de administrador para a imagem de um contêiner, você poderá definir as permissões de acesso para a imagem do contêiner como privada ou pública. As imagens públicas permitem acesso anônimo e podem ser carregadas sem autenticação ou login via CLI.

Como administrador, você também pode conceder permissões de acesso para uma imagem contêiner separada das permissões que você configurou nos níveis da organização e repositório.

No caso de imagens de contêiner publicadas e de propriedade de uma conta pessoal, você pode dar a qualquer pessoa uma função de acesso. Para imagens de contêineres publicadas e pertencentes a uma organização, você pode dar uma função de acesso a qualquer pessoa ou equipe na organização.

Se você está usando um fluxo de trabalho GitHub Actions para gerenciar suas imagens de contêiner, você pode conceder uma função de acesso ao repositório no qual o fluxo de trabalho está armazenado usando a opção de acesso Ações nas configurações do pacote. Para obter mais informações, confira "Como garantir o acesso de fluxo de trabalho ao seu pacote".

PermissãoDescrição de acesso
LerPode fazer o download do pacote.
Pode ler metadados do pacote.
GravarPode fazer upload e download deste pacote.
Pode ler e gravar metadados do pacote.
AdminPode carregar, baixare gerenciar esse pacote.
Pode ler e gravar metadados do pacote.
Pode excluir, restaurar.

Observação: a capacidade dos fluxos de trabalho do GitHub Actions de excluir e restaurar pacotes usando a API REST está atualmente em versão beta pública e sujeita a alterações.

Configurar acesso a imagens de contêiner para sua conta pessoal

Se você tiver permissões de administrador para uma imagem de contêiner que pertence a uma conta pessoal, você poderá atribuir funções de leitura, gravação ou administração a outros usuários. Para obter mais informações sobre essas funções de permissão, confira "Visibilidade e permissões de acesso para imagens de contêiner".

Se o seu pacote for privado ou interno e pertencer a uma organização, você somente poderá dar acesso a outros integrantes ou equipes da organização.

  1. Procurar e selecionar o seu pacote.
  2. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote
  3. Na página de configurações do pacote, clique em Convidar equipes ou pessoas e insira o nome, o nome de usuário ou o email da pessoa à qual deseja permitir acesso. As equipes não podem ter acesso a uma imagem de contêiner de uma conta pessoal. Botão de convite de acesso ao contêiner
  4. Ao lado do nome de usuário ou nome de equipe, use o menu suspenso "Função" para selecionar um nível de permissão desejado. Opções de acesso ao contêiner

Os usuários selecionados receberão acesso automaticamente e não precisarão aceitar um convite primeiro.

Configurar o acesso a imagens de contêiner para uma organização

Se você tiver permissões de administrador para uma imagem de contêiner pertencente à organização, pode atribuir funções de leitura, gravação ou administrador para outros usuários e equipes. Para obter mais informações sobre essas funções de permissão, confira "Visibilidade e permissões de acesso para imagens de contêiner".

Se o seu pacote for privado ou interno e pertencer a uma organização, você somente poderá dar acesso a outros integrantes ou equipes da organização.

  1. Em GitHub, acesse a página principal da sua organização.
  2. No nome da sua organização, clique em Pacotes. Guia Pacotes na página de aterrissagem da organização 3. Procurar e selecionar o seu pacote.
  3. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote
  4. Na página de configurações do pacote, clique em Convidar equipes ou pessoas e insira o nome, o nome de usuário ou o email da pessoa à qual deseja permitir acesso. Você também pode inserir um nome de equipe da organização para dar acesso a todos os integrantes da equipe. Botão de convite de acesso ao contêiner
  5. Ao lado do nome de usuário ou nome de equipe, use o menu suspenso "Função" para selecionar um nível de permissão desejado. Opções de acesso ao contêiner

Os usuários selecionados receberão acesso automaticamente e não precisarão aceitar um convite primeiro.

Herdar acesso a uma imagem de contêiner de um repositório

Para simplificar o gerenciamento de pacotes por meio dos fluxos de trabalho de GitHub Actions, você pode habilitar uma imagem contêiner para herdar as permissões de acesso de um repositório por padrão.

Se você herdar as permissões de acesso do repositório onde os fluxos de trabalho do seu pacote são armazenados, posteriormente, você poderá ajustar o acesso ao seu pacote pelas permissões do repositório.

Uma vez que um repositório é sincronizado, você não poderá acessar as configurações de acesso granular do pacote. Para personalizar as permissões do pacote através das configurações de acesso ao pacote granular, você deverá remover a sincronização do repositório primeiro.

  1. Em GitHub, acesse a página principal da sua organização.
  2. No nome da sua organização, clique em Pacotes. Guia Pacotes na página de aterrissagem da organização 3. Procurar e selecionar o seu pacote.
  3. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote
  4. Em "Origem do repositório", selecione Herdar acesso do repositório (recomendado) . Caixa de seleção Herdar acesso do repositório

Garantir o acesso ao fluxo de trabalho para o seu pacote

Para garantir que um fluxo de trabalho do GitHub Actions tenha acesso ao seu pacote, você deverá conceder acesso explícito ao repositório onde o fluxo de trabalho é armazenado.

O repositório especificado não precisa ser o repositório onde o código-fonte do pacote é mantido. Você pode conceder acesso ao fluxo de trabalho de vários repositórios para um pacote.

Observação: a sincronização da imagem de contêiner com um repositório por meio da opção de menu Acesso ao Actions é diferente da conexão do contêiner com um repositório. Para obter mais informações sobre como vincular um repositório ao seu contêiner, confira "Como conectar um repositório a um pacote".

GitHub Actions acesso para imagens de contêiner pertencentes ao usuário

  1. Procurar e selecionar o seu pacote.
  2. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote
  3. Na barra lateral esquerda, clique em Acesso ao Actions. Opção "Acesso ao Actions" no menu esquerdo
  4. Para garantir que seu fluxo de trabalho tenha acesso ao seu pacote de container, você deve adicionar o repositório em que o fluxo de trabalho é armazenado. Clique em Adicionar repositório e pesquise o repositório que deseja adicionar. Botão "Adicionar repositório"
  5. Ao usar o menu suspenso "função", selecione o nível de acesso padrão que você gostaria que o repositório tivesse na imagem do seu contêiner. Níveis de acesso permitidos para concessão aos repositórios

Para personalizar ainda mais o acesso à sua imagem de contêiner, confira "Como configurar o acesso a imagens de contêiner para sua conta pessoal".

acesso de GitHub Actions para imagens de contêiner pertencentes à organização

  1. Em GitHub, acesse a página principal da sua organização.
  2. No nome da sua organização, clique em Pacotes. Guia Pacotes na página de aterrissagem da organização 3. Procurar e selecionar o seu pacote.
  3. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote
  4. Na barra lateral esquerda, clique em Acesso ao Actions. Opção "Acesso ao Actions" no menu esquerdo
  5. Clique em Adicionar repositório e pesquise o repositório que deseja adicionar. Botão "Adicionar repositório"
  6. Usando o menu suspenso "função", selecione o nível de acesso padrão que você gostaria que os integrantes do repositório tivessem na sua imagem contêiner. Os colaboradores externos não serão incluídos. Níveis de acesso permitidos para concessão aos repositórios

Para personalizar ainda mais o acesso à sua imagem de contêiner, confira "Como configurar o acesso a imagens de contêiner para uma organização".

Garantir acesso do GitHub Codespaces ao seu pacote

Por padrão, um codespace pode acessar diretamente determinados pacotes em registros que oferecem suporte a permissões granulares, como pacotes publicados no mesmo repositório com a opção Herdar acesso selecionada. Para ver a lista de registros do GitHub Packages que dão suporte a permissões granulares e acesso contínuo a GitHub Codespaces, confira "Sobre permissões para GitHub Packages."

Caso contrário, para garantir que um código tenha acesso ao seu pacote, você deverá conceder acesso ao repositório onde o codespace está sendo iniciado.

O repositório especificado não precisa ser o repositório onde o código-fonte do pacote é mantido. Você pode dar acesso a codespaces em vários repositórios a um pacote.

Depois de selecionar o pacote que você está interessado em compartilhar com codespaces de um repositório, você poderá conceder esse acesso ao repositório.

  1. Na barra lateral direita, clique em Configurações do pacote.

    Opção "Configurações do pacote" no menu direito

  2. Em "Gerenciar acesso ao Codespaces", clique em Adicionar repositório.

    Botão "Adicionar repositório"

  3. Pesquise o repositório que você deseja adicionar.

    Botão "Adicionar repositório"

  4. Repita o procedimento para todos os repositórios adicionais que você gostaria de permitir o acesso.

  5. Se os codespaces de um repositório não precisarem mais acessar uma imagem, você poderá remover o acesso.

    Botão "Remover repositório"

Configurar a visibilidade de imagens de contêiner para sua conta pessoal

Ao publicar um pacote, a visibilidade-padrão é privada e só você poderá ver o pacote. Você pode modificar o acesso de uma imagem do contêiner privada ou pública, alterando as configurações de acesso.

Um pacote público pode ser acessado anonimamente sem autenticação. Uma vez que você torna público o seu pacote, mas você não poderá tornar o seu pacote privado novamente.

  1. Procurar e selecionar o seu pacote.

  2. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote

  3. Em "Zona de Perigo", escolha uma configuração de visibilidade:

    • Para tornar a imagem de contêiner visível para qualquer pessoa, clique em Tornar público.

      Aviso: depois de tornar um pacote público, você não poderá torná-lo privado novamente.

    • Para tornar a imagem de contêiner visível para uma seleção personalizada de pessoas, clique em Tornar privada. Opções de visibilidade do contêiner

Visibilidade da criação de contêiner para os integrantes da organização

Você pode escolher a visibilidade de contêineres que os integrantes da organização podem publicar por padrão.

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e clique em Suas organizações. Suas organizações no menu de perfil 2. Ao lado da organização, clique em Configurações. Botão de configurações
  2. À esquerda, clique em Pacotes.
  3. Em "Criação de contêiner", escolha se deseja permitir a criação de imagens públicas, privadas ou internas de contêineres.
    • Para permitir que os membros da organização criem imagens de contêiner públicas, clique em Pública.
    • Para permitir que os membros da organização criem imagens de contêiner privadas visíveis apenas para outros membros da organização, clique em Privada. Você pode personalizar ainda mais a visibilidade de imagens de contêiner privado.
    • Para permitir que os membros da organização criem imagens de contêiner internas que são visíveis para todos os membros da organização, clique em Interna. Se a organização pertencer a uma empresa, as imagens de contêiner ficarão visíveis para todos os integrantes da empresa. Opções de visibilidade para imagens de contêiner publicadas pelos membros da organização

Configurar a visibilidade de imagens de contêiner para uma organização

Ao publicar um pacote, a visibilidade-padrão é privada e só você poderá ver o pacote. Você pode conceder a usuários ou equipes diferentes funções de acesso para sua imagem de contêiner por meio das configurações de acesso.

Um pacote público pode ser acessado anonimamente sem autenticação. Uma vez que você torna público o seu pacote, mas você não poderá tornar o seu pacote privado novamente.

  1. Em GitHub, acesse a página principal da sua organização.

  2. No nome da sua organização, clique em Pacotes. Guia Pacotes na página de aterrissagem da organização 3. Procurar e selecionar o seu pacote.

  3. No canto superior direito da página de aterrissagem do pacote, clique em Configurações do pacote. Botão de configurações do pacote

  4. Em "Zona de Perigo", escolha uma configuração de visibilidade:

    • Para tornar a imagem de contêiner visível para qualquer pessoa, clique em Tornar público.

      Aviso: depois de tornar um pacote público, você não poderá torná-lo privado novamente.

    • Para tornar a imagem de contêiner visível para uma seleção personalizada de pessoas, clique em Tornar privada. Opções de visibilidade do contêiner