Exibir ou modificar a configuração de um repositório

Você pode visualizar e atualizar detalhes sobre seu repositório usando o CodeArtifact console ou o AWS Command Line Interface (AWS CLI).

nota

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

Exibir ou modificar a configuração de um repositório (console)

Você pode ver detalhes e atualizar seu repositório usando o CodeArtifact 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 escolha o nome do repositório que você deseja exibir ou modificar.

3. Expanda Detalhes para ver o seguinte:

   • O domínio do repositório. Escolha o nome do domínio para saber mais sobre ele.

   • A política de recursos do repositório. Escolha Aplicar uma política de repositório para adicionar uma.

   • O nome do recurso da Amazon (ARN) do repositório.

   • Se o seu repositório tiver uma conexão externa, você poderá escolher a conexão para saber mais sobre ela. Um repositório pode ter apenas uma conexão externa. Para ter mais informações, consulte Conectar um CodeArtifact repositório a um repositório público.

   • Se o repositório tiver repositórios upstream, você poderá escolher um para ver os detalhes. Um repositório pode ter até dez repositórios diretos upstream. Para ter mais informações, consulte Trabalhando com repositórios upstream em CodeArtifact.

   nota

   Um repositório pode ter uma conexão externa ou repositórios upstream, mas não ambos.

4. Em Pacotes, você pode ver todos os pacotes que estão disponíveis nesse repositório. Escolha um pacote para saber mais sobre ele.

5. Escolha Exibir instruções de conexão e, em seguida, escolha um gerenciador de pacotes para aprender como configurá-lo CodeArtifact.

6. Escolha Aplicar uma política de repositório para atualizar ou adicionar uma política de recursos ao repositório. Para ter mais informações, consulte Políticas de repositório.

7. Escolha Editar para adicionar ou atualizar o seguinte.

   • A descrição do repositório.

   • As tags associadas ao repositório.

   • Se o repositório tiver uma conexão externa, você poderá alterar a qual repositório público ele se conecta. Caso contrário, você poderá adicionar um ou mais repositórios existentes como repositórios upstream. Organize-os na ordem em que você deseja que sejam priorizados CodeArtifact quando um pacote for solicitado. Para ter mais informações, consulte Ordem de prioridade do repositório upstream.

Exibir ou modificar a configuração de um repositório (AWS CLI)

Para visualizar a configuração atual de um repositório em CodeArtifact, use o describe-repository comando.

aws codeartifact describe-repository --domain my_domain --domain-owner 111122223333 --repository my_repo

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"
        "upstreams": [],
        "externalConnections": []
    }
}

Modificar a configuração upstream de um repositório

Um repositório upstream permite que um cliente gerenciador de pacotes acesse os pacotes contidos em mais de um repositório usando um único endpoint de URL. Para adicionar ou alterar o relacionamento upstream de um repositório, use o comando update-repository.

aws codeartifact update-repository --domain my_domain --domain-owner 111122223333 --repository my_repo \
       --upstreams repositoryName=my-upstream-repo

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"
        "upstreams": [
            {
                "repositoryName": "my-upstream-repo"
            }
        ],
        "externalConnections": []
    }
}

nota

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

Para remover a relação upstream de um repositório, use uma lista vazia como argumento para a opção --upstreams.

aws codeartifact update-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --upstreams []

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"
        "upstreams": [],
        "externalConnections": []
    }
}