Criar um repositório

Como todos os pacotes CodeArtifact são armazenados em repositórios, para usar CodeArtifact, você deve criar um. Você pode criar um repositório usando o CodeArtifact console, o AWS Command Line Interface (AWS CLI) ou AWS CloudFormation. Cada repositório está associado à AWS conta que você usa ao criá-lo. Você pode ter vários repositórios e eles são criados e agrupados em domínios. Quando você cria um repositório, ele não contém nenhum pacote. Os repositórios são poliglotas, o que significa que um único repositório pode conter pacotes de qualquer tipo compatível.

Para obter informações sobre limites de CodeArtifact serviço, como o número máximo de repositórios permitidos em um único domínio, consulteCotas em AWS CodeArtifact. Se você atingir o número máximo de repositórios permitidos, poderá excluir repositórios para abrir espaço para mais.

Um repositório pode ter um ou mais CodeArtifact repositórios associados a ele como repositórios upstream. Isso permite que um cliente gerenciador de pacotes acesse os pacotes contidos em mais de um repositório usando um único URL endpoint. Para ter mais informações, consulte Trabalhando com repositórios upstream em CodeArtifact.

Para obter mais informações sobre como gerenciar CodeArtifact repositórios com CloudFormation, consulteCriando CodeArtifact recursos com AWS CloudFormation.

nota

Depois de criar um repositório, não é possível alterar o nome, a conta AWS associada ou o domínio dele.

Criar um repositório (console)

1. Abra o AWS CodeArtifact console em https://console.aws.amazon.com/codesuite/codeartifact/home.

2. No painel de navegação, escolha Repositórios e, em seguida, escolha Criar repositório.

3. Para Nome do repositório, insira um nome para o repositório.

4. (Opcional) Em Descrição do repositório, insira uma descrição opcional para esse repositório.

5. (Opcional) Em Publicar repositórios upstream, adicione repositórios intermediários que conectem seus repositórios às autoridades de pacotes, como Maven Central ou npmjs.com.

6. Escolha Próximo.

7. Em AWSConta, escolha Esta AWS conta se você estiver conectado à conta proprietária do domínio. Escolha AWSConta diferente se outra AWS conta for proprietária do domínio.

8. Em Domínio, escolha o domínio no qual o repositório será criado.

   Se não houver domínios na conta, você deve criar um. Em Nome do domínio, insira o nome do novo domínio.

   Expanda Configuração Adicional.

   Você deve usar uma AWS KMS key (KMSchave) para criptografar todos os ativos em seu domínio. Você pode usar uma Chave gerenciada pela AWS ou uma KMS chave que você gerencia:

   Importante

   CodeArtifact suporta apenas KMSteclas simétricas. Você não pode usar uma KMSchave assimétrica para criptografar seus domínios. CodeArtifact Para obter ajuda para determinar se uma KMS chave é simétrica ou assimétrica, consulte Identificação de chaves simétricas e assimétricas. KMS

   • Escolha a chave AWS gerenciada se quiser usar a chave padrão Chave gerenciada pela AWS.

   • Escolha Chave gerenciada pelo cliente se quiser usar uma KMS chave que você gerencia. Para usar uma KMS chave que você gerencia, em Chave gerenciada pelo cliente ARN, pesquise e escolha a KMS chave.

   Para obter mais informações, consulte Chaves gerenciadas pela AWS e Chave gerenciada pelo cliente no Guia do desenvolvedor do AWS Key Management Service .

9. Escolha Próximo.

10. Em Revisar e criar, revise o que CodeArtifact está criando para você.

    • Fluxo do pacote mostra como domínio e repositórios estão conectados.

    • Etapa 1: Criar repositório mostra detalhes sobre o repositório e os repositórios upstream opcionais que serão criados.

    • Etapa 2: Selecionar domínio mostra detalhes sobre my_domain.

    Quando estiver pronto, escolha Criar repositório.

Criar um repositório (AWS CLI)

Use o comando create-repository para criar um repositório no seu domínio.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --description "My new repository"

Resultado do exemplo:

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": "[]",
        "externalConnections"" "[]"
    }
}

Um novo repositório não contém nenhum pacote. Cada repositório está associado à conta AWS na qual você está autenticado quando o repositório é criado.

Criar um repositório com tags

Para criar um repositório com tags, adicione o parâmetro --tags ao seu comando create-domain.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --tags key=k1,value=v1 key=k2,value=v2

Criar um repositório com um repositório upstream

Você pode especificar um ou mais repositórios upstream ao criar um repositório.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --upstreams repositoryName=my-upstream-repo --repository-description "My new repository"

Resultado do exemplo:

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": [
            {
                "repositoryName": "my-upstream-repo"
            }
        ],
        "externalConnections"" "[]"
    }
}

nota

Para criar um repositório com um upstream, você deve ter permissão para a ação AssociateWithDownstreamRepository no repositório upstream.

Para adicionar um upstream a um repositório após sua criação, consulte Adicionar ou remover repositórios upstream (console) e Adicionar ou remover repositórios upstream (AWS CLI).