Conceitos básicos do uso da AWS CLI

Execute as etapas a seguir para começar com o CodeArtifact usando a AWS Command Line Interface (AWS CLI). Para obter mais informações, consulte Instalar ou atualizar e configurar a AWS CLI. Este guia usa o gerenciador de pacotes npm. Se você estiver usando um gerenciador de pacotes diferente, será necessário adaptar algumas das etapas a seguir.

Use a AWS CLI para executar o comando create-domain.


aws codeartifact create-domain --domain my-domain

Os dados formatados em JSON aparecem no resultado com detalhes sobre seu novo domínio.


{
    "domain": {
        "name": "my-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
        "status": "Active",
        "createdTime": "2020-10-07T15:36:35.194000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

Se você receber o erro Could not connect to the endpoint URL, verifique se AWS CLI está configurado e se o Nome da região padrão está definido como a mesma região em que o repositório foi criado. Consulte Configurar a interface de linha de comando da AWS.

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

Os dados formatados em JSON aparecem no resultado com detalhes sobre seu novo repositório.


{
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [],
        "externalConnections": []
    }
}

Use o comando create-repository para criar um repositório upstream para seu repositório my-repo.


aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store

Os dados formatados em JSON aparecem no resultado com detalhes sobre seu novo repositório.


{
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": []
    }
}

Use o comando associate-external-connection para adicionar uma conexão externa com o repositório público npm ao seu repositório npm-store.


aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"

Os dados formatados em JSON aparecem no resultado com detalhes sobre o repositório e a nova conexão externa dele.


{
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

Para obter mais informações, consulte Conectar um CodeArtifact repositório a um repositório público.

Use o comando update-repository para associar o repositório npm-store como um repositório upstream ao repositório my-repo.


aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store

Os dados formatados em JSON aparecem no resultado com detalhes sobre o repositório atualizado, incluindo o novo repositório upstream.


{
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [
            {
                "repositoryName": "npm-store"
            }
        ],
        "externalConnections": []
    }
}

Para obter mais informações, consulte Adicionar ou remover repositórios upstream (AWS CLI).

Use o comando login para configurar o gerenciador de pacotes npm com o repositório my-repo.


aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333

Você deve receber uma confirmação de que o login foi bem-sucedido.


Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
Login expires in 12 hours at 2020-10-08 02:45:33-04:00

Para obter mais informações, consulte Configure e use o npm com CodeArtifact.

Use a CLI do npm para instalar o pacote npm. Por exemplo, para instalar o popular pacote npm lodash, use o seguinte comando.
```
npm install lodash
```
Use o comando list-packages para visualizar o pacote que você acabou de instalar no repositório my-repo.

nota
Pode haver um atraso entre a conclusão do comando npm install de instalação e o momento em que o pacote aparece no seu repositório. Para obter detalhes sobre essa latência típica ao buscar pacotes de repositórios públicos, consulte. Latência da conexão externa
```
aws codeartifact list-packages --domain my-domain --repository my-repo
```
Os dados formatados em JSON aparecem no resultado com o formato e o nome do pacote instalado.
```
{
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
    ]
}
```
Agora você tem três recursos do CodeArtifact:
- O domínio my-domain.
- Um repositório my-repo contido em my-domain. Esse repositório tem um pacote npm disponível para ele.
- Um repositório npm-store contido em my-domain. Esse repositório tem uma conexão externa com o repositório npm público e está associado como um repositório upstream ao repositório my-repo.

Para evitar cobranças adicionais da AWS, exclua os recursos utilizados durante este tutorial:

nota

Você não pode excluir um domínio que contenha repositórios, então você deve excluir my-repo e npm-store antes de excluir my-domain.

Use o comando delete-repository para excluir o repositório npm-store.


aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo

Os dados formatados em JSON aparecem no resultado com detalhes sobre o repositório excluído.


{
    "repository": {
        "name": "my-repo",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
        "upstreams": [
            {
                "repositoryName": "npm-store"
            }
        ],
        "externalConnections": []
    }
}

Use o comando delete-repository para excluir o repositório npm-store.


aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store

Os dados formatados em JSON aparecem no resultado com detalhes sobre o repositório excluído.


{
    "repository": {
        "name": "npm-store",
        "administratorAccount": "111122223333",
        "domainName": "my-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

Use o comando delete-domain para excluir o repositório my-domain.


aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333

Os dados formatados em JSON aparecem no resultado com detalhes sobre o domínio excluído.


{
    "domain": {
        "name": "my-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
        "status": "Deleted",
        "createdTime": "2020-10-07T15:36:35.194000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Conceitos básicos que usam o console

Trabalhar com repositórios