As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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-owner111122223333
--repositorymy-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-owner111122223333
--repositorynpm-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-owner111122223333
--repositorynpm-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óriomy-repo
.aws codeartifact update-repository --repository
my-repo
--domainmy-domain
--domain-owner111122223333
--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
--domainmy-domain
--domain-owner111122223333
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:00Para 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 externaaws codeartifact list-packages --domain
my-domain
--repositorymy-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 emmy-domain
. Esse repositório tem um pacote npm disponível para ele. -
Um repositório
npm-store
contido emmy-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óriomy-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
enpm-store
antes de excluirmy-domain
.-
Use o comando delete-repository para excluir o repositório
npm-store
.aws codeartifact delete-repository --domain
my-domain
--domain-owner111122223333
--repositorymy-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-owner111122223333
--repositorynpm-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-owner111122223333
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 } }
-