Faturamento para armazenamento e tráfego extraído

Dependendo do plano de serviço escolhido, você será cobrado pelo armazenamento e pelo tráfego de pull usados por mês em cada região.

Limites de cota para armazenamento e tráfego extraído

Dependendo do plano de serviço escolhido, será possível enviar imagens por push e fazer pull de imagens para e de seu namespace, até atingir seus limites de cota específicos do plano ou customizados para cada região.

Custo do {{site.data.keyword.registryshort}}

Você pode consultar os custos do “ {{site.data.keyword.registrylong_notm}} ” na seção de planos de preços da página de detalhes da oferta. Para obter mais informações, consulte {{site.data.keyword.registryshort_notm}}.

Imagem do contêiner

Um sistema de arquivos e seus parâmetros de execução usados dentro de um tempo de execução do contêiner para criar um contêiner. O sistema de arquivos consiste em uma série de camadas, que são combinadas no tempo de execução, que são criadas à medida que a imagem de contêiner é construída por atualizações sucessivas. A imagem do contêiner não mantém seu estado à medida que o contêiner é executado.

As imagens de contêiner são armazenadas em um repositório que é armazenado em um namespace.

Compilação

As compilações são usadas como referências imutáveis para vários objetos no registro, como manifestos de imagem, camadas e itens de configuração.

No contexto do registro, uma compilação de imagem é uma referência imutável para uma imagem, que a identifica usando o hash sha256 do manifesto de imagem. É possível usar uma compilação de imagem para garantir que você sempre fará referência à mesma versão de uma imagem. Use o formato longo da compilação de imagem para trabalhar com as imagens, como para fazer pull, enviar por push e exclui-las.

Para localizar a compilação de imagem, execute o comando ibmcloud cr image-digests. O comando ibmcloud cr image-list também retorna a compilação de imagem, mas, por padrão, ele está em um formato truncado. É possível incluir uma opção ao comando ibmcloud cr image-list para retornar a compilação de imagem no formato longo.

Ao usar o hash de imagem para identificar uma imagem, utilize sempre o formato longo.

No {{site.data.keyword.registryshort}}, qualquer referência à "compilação" significa "compilação de imagem".

Dockerfile

Um Dockerfile é um arquivo de texto que contém instruções para construir uma imagem do Docker.

Geralmente, uma imagem de contêiner é construída sobre uma imagem base que contém um sistema operacional base, como o Ubuntu. É possível mudar incrementalmente a imagem base com suas instruções do Dockerfile para definir o ambiente que o app precisa executar. Cada mudança na imagem base descreve uma nova camada da imagem. É possível fazer múltiplas mudanças em uma única linha do Dockerfile. As instruções em um Dockerfile também podem fazer referência a artefatos de compilação armazenados separadamente, como um aplicativo, a configuração do aplicativo e suas dependências. Para obter mais informações sobre o Dockerfile, consulte a referência do Dockerfile.

Imagens de contêiner do Docker V2

Uma imagem de contêiner que está em conformidade com a especificação Image Manifest Version 2, schema 2.

O tipo de mídia para o Docker Image Manifest V2, Esquema 2 é application/vnd.docker.distribution.manifest.v2+json e o tipo de mídia para a lista de manifest é application/vnd.docker.distribution.manifest.list.v2+json. Uma imagem de contêiner do Docker V2 é um tipo de imagem de contêiner do OCI. Para obter mais informações sobre suporte para o Docker, consulte Docker.

Nome de domínio

O nome de um sistema host. Um nome de domínio consiste em uma sequência de subnomes que são separados por um caractere delimitador, por exemplo, www.ibm.com.

Os nomes de domínio que o {{site.data.keyword.registryshort}} usa estão no formato us.icr.io. Nomes de domínio anteriores que o {{site.data.keyword.registryshort}} usava estão no formato registry.ng.bluemix.net. Ambos os formatos de nome de domínio referem-se a um mesmo registro e conteúdo. O serviço do {{site.data.keyword.registryshort}} responde a nomes de domínio anteriores e canônicos igualmente. É possível enviar por push e fazer pull de imagens usando o nome de domínio de forma intercambiável.

O nome de domínio só é significativo nas seguintes situações:

• Quando o Kubernetes está selecionando um segredo de extração, ele escolhe um que corresponda ao nome de domínio.
• Quando ibmcloud cr login está ajudando-o a efetuar login, ele usa nomes de domínio apenas no formato us.icr.io.
• Quando as imagens são assinadas, a assinatura inclui o nome de domínio que foi usado no momento da assinatura.

Para obter mais informações sobre os nomes de domínio que o {{site.data.keyword.registryshort}} usa, consulte Regiões.

Manifesto de imagem

Um manifesto de imagem é um documento .json que faz referência ao objeto de configuração e às camadas de imagem que são necessários para fazer pull e executar a imagem. O hash sha256 do manifesto de imagem é a compilação, que é usada para identificar a imagem. É possível visualizar o manifesto de imagem executando o comando ibmcloud cr manifest-inspect.

Imagens do contêiner do OCI

Uma imagem de contêiner que está em conformidade com a especificação do Formato de Imagem OCI.

O tipo de mídia para imagens do contêiner do OCI é application/vnd.oci.image.manifest.v1+json.

Registro

Um serviço de armazenamento e distribuição de imagem de contêiner público ou privado.

É oferecido armazenamento para imagens de contêineres OCI (também conhecidas como imagens de contêineres “ Docker ”). As imagens de contêiner do OCI podem ser acessadas ou extraídas por clientes OCI que usam o nome de domínio de registro apropriado. As imagens de contêiner podem ser acessadas por qualquer pessoa (imagens públicas) ou o acesso pode ser limitado a um grupo (imagens privadas). O {{site.data.keyword.registryshort}} fornece um registro de imagem privada, de diversos locatários e altamente disponível, que é hospedado e gerenciado pela {{site.data.keyword.IBM_notm}}. É possível usar o registro incluindo um namespace que é privado em sua conta e, em seguida, enviando por push imagens para o namespace.

Namespace do registro

Uma pasta que contém pastas ou repositórios que armazenam suas imagens de contêiner em {{site.data.keyword.registryshort}}. O namespace de registro está associado à sua conta do {{site.data.keyword.cloud_notm}}. É possível ter diversos namespaces de registro em uma conta.

Quando você configura seu próprio namespace em {{site.data.keyword.registryshort}}, o namespace é anexado ao registro URL <region>.icr.io/<my_namespace>, em que <region> é a região e <my_namespace> é o seu namespace. O namespace deve ser exclusivo em todas as contas do {{site.data.keyword.cloud_notm}} na mesma região. Todos os usuários da sua conta {{site.data.keyword.cloud_notm}} que têm as permissões corretas do IAM podem visualizar e trabalhar com imagens armazenadas no namespace do registro.

É possível ter 100 namespaces em cada região.

Os namespaces são criados em um grupo de recursos especificado por você, para que seja possível configurar o acesso aos recursos dentro do namespace no nível do grupo de recursos. Se você não especificar um grupo de recursos e um não for apontado como destino, o grupo de recursos padrão será usado. Se você tiver um namespace mais antigo que não esteja em um grupo de recursos, poderá atribuí-lo a um grupo de recursos e, em seguida, definir permissões para esse namespace no nível do grupo de recursos. Para obter mais informações sobre os grupos de recursos, consulte Designando namespaces existentes a grupos de recursos.

Os namespaces atribuídos a um grupo de recursos são exibidos na página Lista de recursos do console do {{site.data.keyword.cloud_notm}}.

Repositório

Armazena uma coleção de imagens de contêineres relacionados. Um repositório é armazenado em um namespace. As imagens do contêiner são diferenciadas apenas por tag ou resumo. O termo “repositório” costuma ser usado de forma intercambiável com “imagem de contêiner”, mas um repositório pode conter várias variantes marcadas de uma imagem de contêiner.

Marcar

Um identificador que é conectado a imagens de contêiner dentro de um repositório. As tags podem ser redesignadas ou excluídas das imagens.

Você pode usar tags para distinguir diferentes versões da mesma imagem base dentro de um repositório. Quando você executa um comando do Docker e não especifica a tag de uma imagem do repositório, a imagem identificada como latest é usada por padrão.

Imagem não identificada

Uma imagem que não tem tag é uma imagem sem tag. As imagens sem tags podem ser referenciadas usando o formato de referência de compilação <repository>@<digest>, ao contrário do formato de referência da tag <repository>:<tag>. Imagens sem tag são tipicamente o resultado de uma imagem que é enviada por push com uma combinação <repository>:<tag> preexistente. Nesse caso, a tag é substituída e a imagem original fica sem identificação.

Você pode visualizar todas as suas imagens marcadas e não marcadas executando o comando ibmcloud cr image-digests comando. Se quiser visualizar apenas as imagens não marcadas, você pode executar o comando ibmcloud cr image-digests com a formatação da linguagem Go, consulte Exemplo de comando de formatação Go para ibmcloud cr image-digests. Se quiser remover suas imagens não marcadas, você pode executar o comando ibmcloud cr image-prune-untagged comando.

Registro global

Um registro global está disponível. O registro global não inclui uma região em seu nome (icr.io). Além de hospedar namespaces e imagens do usuário, esse registro também hospeda imagens públicas que são fornecidas por {{site.data.keyword.IBM_notm}}.

A instância global do {{site.data.keyword.registryshort}} está disponível usando-se os nomes de domínio mostrados na tabela a seguir.

Para saber mais sobre como se conectar ao {{site.data.keyword.registryshort}} usando os nomes de domínio privado, consulte Usando conexões de rede privada.

Os nomes de domínio bluemix.net existentes foram descontinuados, mas será possível continuar a usá-los por enquanto. Uma data de término do suporte ainda não está disponível.

Regiões locais

As instâncias regionais do {{site.data.keyword.registryshort}} estão disponíveis usando os nomes de domínio mostrados na tabela a seguir.

Para saber mais sobre como se conectar ao {{site.data.keyword.registryshort}} usando os nomes de domínio privado, consulte Usando conexões de rede privada.

Os nomes de domínio bluemix.net existentes foram descontinuados, mas será possível continuar a usá-los por enquanto. Uma data de término do suporte ainda não está disponível.

Suporte para o Docker

{{site.data.keyword.registrylong_notm}} é compatível com as versões de Docker Engine suportadas por Docker.

O Docker só será necessário em caso de envio por push ou extração de imagens.

As imagens do Docker V2, esquema 2 contam com suporte. As listas de manifest também são suportadas. Para obter mais informações, consulte Compatibilidade do registro.

As imagens do Docker V2 Schema 1 foram descontinuadas e não será mais possível enviá-las por push para o {{site.data.keyword.registryshort}}.

Suporte a outros clientes

{{site.data.keyword.registrylong_notm}} oferece suporte às versões compatíveis de clientes que estão em conformidade com a especificação de distribuição OCI versão 1 ou posterior, como Buildah, Podman e Skopeo.