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 has different hosting locations, permission, and visibility than other package registries.
| Registros de pacotes | Registro de contêiner do GitHub | |
|---|---|---|
| Locais de hospedagem | Você 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ões | Você 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. |
| Visibilidade | Você 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. |
For more information, see "About scopes and permissions for 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 pacote | Linguagem | Formato do pacote | Descrição |
|---|---|---|---|
| arquivo Docker | N/A | arquivo Docker | Plataforma 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ão | Descrição de acesso |
|---|---|
| Leitura | Pode fazer o download do pacote. Pode ler metadados do pacote. |
| Gravação | Pode fazer upload e download deste pacote. Pode ler gravar metadados do pacote. |
| Administrador | Pode 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.
| Escopo | Descrição |
|---|---|
read:packages | Faça o download e instale as imagens de contêiner de Registro de contêiner do GitHub |
write:packages | Faça o upload e publique as imagens do contêiner para Registro de contêiner do GitHub |
delete:packages | Exclua 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". |
To learn about available scopes and permissions for container images, see "Configuring access control and visibility for container images."
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.