Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Primeros pasos con AWS CLI Siga estos pasos para comenzar a utilizar CodeArtifact usando la AWS Command Line Interface (AWS CLI). Para obtener más información, consulte [Instale o actualice y, a continuación, configure el AWS CLI](get-set-up-install-cli.md). Esta guía usa el administrador de paquetes `npm`. Si está utilizando un administrador de paquetes diferente, deberá modificar algunos de los siguientes pasos. 1. Utilice la AWS CLI para ejecutar el comando **create-domain**. ``` aws codeartifact create-domain --domain my-domain ``` Los datos con formato JSON aparecen en la salida con detalles sobre tu nuevo dominio. ``` { "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 } } ``` Si recibe el error `Could not connect to the endpoint URL`, asegúrese de que su AWS CLI está configurada y de que el **nombre de región predeterminado** es la misma región en la que creó el repositorio (consulte [Configuración de la interfaz de línea de comandos de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)). 1. Utilice el comando **create-repository** para crear un repositorio en su dominio. ``` aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo ``` Los datos con formato JSON aparecen en la salida con detalles sobre el nuevo repositorio. ``` { "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": [] } } ``` 1. Usa el comando **create-repository** para crear un repositorio ascendente para su repositorio `my-repo`. ``` aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store ``` Los datos con formato JSON aparecen en la salida con detalles sobre el nuevo repositorio. ``` { "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": [] } } ``` 1. Use el comando **associate-external-connection** para añadir a su repositorio una conexión externa al repositorio público npm a su repositorio `npm-store`. ``` aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs" ``` Los datos con formato JSON aparecen en la salida con detalles sobre el repositorio y su nueva conexión externa. ``` { "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 obtener más información, consulte [Conectar un CodeArtifact repositorio a un repositorio público](external-connection.md). 1. Utilice el comando **update-repository** para asociar el repositorio `npm-store` como repositorio ascendente al repositorio `my-repo`. ``` aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store ``` Los datos con formato JSON aparecen en la salida con detalles sobre el repositorio actualizado, incluido su nuevo repositorio ascendente. ``` { "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 obtener más información, consulte [Añadir o eliminar repositorios ascendentes (AWS CLI)](repo-upstream-add.md#repo-upstream-add-cli). 1. Use el comando **login** para configurar su administrador de paquetes npm con su repositorio `my-repo`. ``` aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333 ``` Debería recibir un resultado que confirme que su inicio de sesión se realizó correctamente. ``` 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 obtener más información, consulte [Configure y use npm con CodeArtifact](npm-auth.md). 1. Utilice la CLI de npm para instalar un paquete npm. Por ejemplo, para instalar el popular `lodash` del paquete npm, utilice el siguiente comando. ``` npm install lodash ``` 1. Use el comando **list-packages** para ver el paquete que acaba de instalar en su repositorio `my-repo`. **nota** Puede haber un retraso entre el momento en que se completa el comando de instalación `npm install` y el momento en que el paquete está visible en el repositorio. Para obtener más información sobre la latencia típica al recuperar paquetes de repositorios públicos, consulte [Latencia de conexión externa](external-connection-requesting-packages.md#external-connection-latency). ``` aws codeartifact list-packages --domain my-domain --repository my-repo ``` Los datos con formato JSON aparecen en la salida con el formato y el nombre del paquete que ha instalado. ``` { "packages": [ { "format": "npm", "package": "lodash" } ] } ``` Ahora tiene tres recursos de CodeArtifact: + El dominio `my-domain`. + El repositorio `my-repo` que se encuentra en `my-domain`. Este repositorio tiene un paquete npm disponible. + El repositorio `npm-store` que se encuentra en `my-domain`. Este repositorio tiene una conexión externa al repositorio público de npm y está asociado como un repositorio ascendente con el repositorio `my-repo`. 1. Para evitar cargos AWS adicionales, elimine los recursos utilizados en este tutorial: **nota** No puede eliminar un dominio que contenga repositorios, por lo que debe eliminar `my-repo` y `npm-store` antes de eliminar `my-domain`. 1. Utilice el comando **delete-repository** para eliminar el repositorio `npm-store`. ``` aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo ``` Los datos con formato JSON aparecen en la salida con detalles sobre el repositorio eliminado. ``` { "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": [] } } ``` 1. Utilice el comando **delete-repository** para eliminar el repositorio `npm-store`. ``` aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store ``` Los datos con formato JSON aparecen en la salida con detalles sobre el repositorio eliminado. ``` { "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" } ] } } ``` 1. Utilice el comando **delete-domain** para eliminar el repositorio `my-domain`. ``` aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333 ``` Los datos con formato JSON aparecen en la salida con detalles sobre el dominio eliminado. ``` { "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 } } ```