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 recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Sobre o GitHub Container Registry

Você pode usar Registro de contêiner do GitHub para hospedar e gerenciar imagens do contêiner Docker na sua organização ou conta pessoal em GitHub. O Registro de contêiner do GitHub permite que você configure quem pode gerenciar e acessar pacotes usando permissões refinadas.

GitHub Package Registry está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server 2.22, e GitHub One.


O GitHub Package Registry não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. GitHub Package Registry está disponível com GitHub Free, GitHub Pro, GitHub Free para organizações, GitHub Team, GitHub Enterprise Cloud e GitHub One. Para obter mais informações, consulte "[produtos de GitHub](/articles/github-s-products)

Neste artigo

Nota: Registro de contêiner do GitHub está atualmente em versão beta público e sujeito a alterações. Durante o beta, o armazenamento e a banda larga são grátis. Para usar Registro de contêiner do GitHub, você deve habilitar o recurso para sua conta. Para obter mais informações, consulte "Habilitar suporte ao contêiner aprimorado".

Sobre o Registro de contêiner do GitHub

Com o registro do container, você pode:

  • Armazenar imagens de contêiner na sua conta de organização e usuário, em vez de um repositório.
  • Definir permissões e visibilidade refinadas e independentes das permissões e visibilidade do repositório.
  • Acessar imagens de contêineres públicos anonimamente.

Para compartilhar o contexto sobre o uso do seu pacote, você pode vincular um repositório à sua imagem de contêiner no GitHub. Para obter mais informações, consulte "Conectar um repositório a uma imagem de contêiner".

Registro de contêiner do GitHub tem locais de hospedagem diferentes, permissão e visibilidade diferentes dos outros registros de pacotes.

Registros de pacotesRegistro de contêiner do GitHub
Locais de hospedagemVocê pode hospedar vários pacotes em um só repositório.Você pode hospedar várias imagens de contêiner em uma organização ou conta de usuário.
PermissõesVocê pode publicar pacotes em um repositório público (pacotes públicos) para compartilhar com tudo de GitHub, ou em um repositório privado (pacotes privados) para compartilhar com os colaboradores ou uma organização. You can use GitHub roles and teams to limit who can install or publish each package, as packages inherit the permissions of the repository. Anyone with read permissions for a repository can install a package as a dependency in a project, and anyone with write permissions can publish a new package version.Para cada imagem de container, você pode escolher o nível de acesso que os outros têm. As permissões para acesso a imagens do contêiner são separadas da sua organização e das permissões do repositório.
VisibilidadeVocê pode publicar pacotes em um repositório público (pacotes públicos) para compartilhar com tudo de GitHub, ou em um repositório privado (pacotes privados) para compartilhar com os colaboradores ou uma organização.Você pode definir a visibilidade de cada uma de suas imagens de contêiner. Uma imagem privada de contêiner só é visível para pessoas e equipes às quais é fornecido acesso na sua organização. Qualquer pessoa pode ver uma imagem pública de contêiner.

Para obter mais informações, consulte "Sobre escopos e permissões para Registro de contêiner do GitHub".

Formatos compatíveis

O registro de contêiner é atualmente compatível com os seguintes formatos de imagem do contêiner:

O Registro de contêiner do GitHub hospeda contêineres em ghcr.io/OWNER/IMAGE-NAME.

Cliente do pacoteLinguagemFormato do pacoteDescrição
arquivo DockerN/Aarquivo DockerPlataforma de gerenciamento de contêiner Docker

Lista de manifestos/Índices de imagens

Registro de contêiner do GitHub também é compatível com formatos das Listas de Manifesto do Docker/Índice de Imagens de OCI definidos nas especificações do Docker V2, Esquema 2 e na imagem de OCI.

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

Se você tem permissões de administrador para uma imagem de contêiner, você pode definir 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.

Para imagens de contêiner publicadas e pertencentes a uma conta de usuário, 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.

Função de permissãoDescrição de acesso
LeituraPode fazer o download do pacote.
Pode ler metadados do pacote.
GravaçãoPode fazer upload e download deste pacote.
Pode ler gravar metadados do pacote.
AdministradorPode fazer upload, download, excluir e gerenciar este pacote.
Pode ler gravar metadados do pacote.
Pode conceder permissões de pacote.

Para obter mais informações, consulte "Configurar controle de acesso e visibilidade para imagens de contêiner".

About tokens

To install or publish a package, you must use a token with the appropriate scope, and your user account must have appropriate permissions for that repository.

EscopoDescrição
read:packagesFaça o download e instale as imagens de contêiner de Registro de contêiner do GitHub
write:packagesFaça o upload e publique as imagens do contêiner para Registro de contêiner do GitHub
delete:packagesExclua versões especificadas de imagens privadas ou públicas de contêiner do Registro de contêiner do GitHub. Para obter mais informações, consulte "Excluir uma imagem de contêiner".

Para aprender sobre escopos e permissões disponíveis para imagens de contêiner, consulte "Configurar controle de acesso e visibilidade para imagens do contêiner".

Para obter mais informações, consulte "Criar um token de acesso pessoal" e "Escopos disponíveis".

Sobre a cobrança do Registro de contêiner do GitHub

Durante o beta de Registro de contêiner do GitHub, tanto o novo registro de contêiner quanto o registro do Docker de GitHub Package Registry existente será grátis. Para obter mais informações sobre o registro Docker do GitHub Package Registry, consulte "Configurar o Docker para uso com GitHub Package Registry".

Após o beta, as mesmas taxas de cobrança e armazenamento que os outros registros do GitHub Package Registry usam serão aplicadas ao registro do contêiner. Para obter mais informações, consulte "Sobre a cobrança para GitHub Package Registry".

Entrar em contato com o suporte

Se você tiver feedback ou solicitações de recursos para Registro de contêiner do GitHub, use o formulário de feedback.

Entre em contato com Suporte do GitHub sobre Registro de contêiner do GitHub usando o nosso formulário de contato se:

  • Você encontrar qualquer coisa que contradiga a documentação.
  • Você encontra erros vagos ou pouco claros.
  • Seu pacote publicado contém dados confidenciais, como violações do GDPR, Chaves de API ou informações de identificação pessoal.

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.