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. # Configuración con AWS CodeArtifact Si ya se ha inscrito en Amazon Web Services (AWS), puede comenzar a utilizar AWS CodeArtifact de inmediato. Puedes abrir la CodeArtifact consola, elegir **Crear un dominio y un repositorio** y seguir los pasos del asistente de inicio para crear tu primer dominio y repositorio. Si AWS aún no te has registrado o necesitas ayuda para crear tu primer dominio y repositorio, realiza las siguientes tareas para configurarlo para usarlo CodeArtifact: **Topics** + [Inscríbete en AWS](get-set-up-sign-up-for-aws.md) + [Instale o actualice y, a continuación, configure el AWS CLI](get-set-up-install-cli.md) + [Aprovisionar un usuario de IAM](get-set-up-provision-user.md) + [Instale su administrador de paquetes o herramienta de compilación](getting-started-install-package-manager.md) # Inscríbete en AWS Al suscribirse a Amazon Web Services (AWS), solo se le cobrará por los servicios y recursos que utilice, incluidos AWS CodeArtifact los siguientes: Si ya tienes una Cuenta de AWS, pasa a la siguiente tarea,[Instale o actualice y, a continuación, configure el AWS CLI](get-set-up-install-cli.md). Si no tiene uno Cuenta de AWS, utilice el siguiente procedimiento para crearlo. **Para crear un Cuenta de AWS** 1. Abre el [https://portal.aws.amazon.com/billing/registro](https://portal.aws.amazon.com/billing/signup). 1. Siga las instrucciones que se le indiquen. Parte del procedimiento de registro consiste en recibir una llamada telefónica o mensaje de texto e indicar un código de verificación en el teclado del teléfono. Cuando te registras en un Cuenta de AWS, *Usuario raíz de la cuenta de AWS*se crea un. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar [Tareas que requieren acceso de usuario raíz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). # Instale o actualice y, a continuación, configure el AWS CLI Para llamar a CodeArtifact los comandos desde AWS Command Line Interface (AWS CLI) en una máquina de desarrollo local, debe instalar el AWS CLI. Si tiene una versión anterior de la AWS CLI instalada, debe actualizarla para que los CodeArtifact comandos estén disponibles. CodeArtifact los comandos están disponibles en las siguientes AWS CLI versiones: 1. **AWS CLI 1:** 1.18.77 y versiones posteriores 1. **AWS CLI 2:2.0.21** y versiones posteriores Para comprobar la versión, utilice el comando `aws --version`. **Para instalar y configurar el AWS CLI** 1. Instale o actualice AWS CLI el siguiendo las instrucciones de [Instalación del AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html). 1. Configure el AWS CLI, con el comando **configure**, de la siguiente manera. ``` aws configure ``` Cuando se le solicite, especifique la clave de AWS acceso y la clave de acceso AWS secreta del usuario de IAM con CodeArtifact el que vaya a utilizar. Cuando se le solicite el nombre predeterminado de la Región de AWS , especifique la región en la que creará la canalización, como `us-east-2`. Cuando se le pregunte el formato de salida predeterminado, indique `json`. **importante** Al configurar el AWS CLI, se le solicitará que especifique un Región de AWS. Especifique una de las regiones admitidas que se encuentran en la lista de [Regiones y puntos de enlace](https://docs.aws.amazon.com/general/latest/gr/codeartifact.html) de la *Referencia general de AWS*. Para obtener más información, consulte [Configuración de AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) y [Administración de claves de acceso para usuarios de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html). 1. Para verificar la instalación o actualización, llame al siguiente comando desde la AWS CLI. ``` aws codeartifact help ``` Si se ejecuta correctamente, este comando muestra una lista de los CodeArtifact comandos disponibles. A continuación, puede crear un usuario de IAM y concederle acceso a CodeArtifact. Para obtener más información, consulte [Aprovisionar un usuario de IAM](get-set-up-provision-user.md). # Aprovisionar un usuario de IAM Siga estas instrucciones para preparar a un usuario de IAM para su uso. CodeArtifact **Para aprovisionar a un usuario de IAM** 1. Cree un usuario de IAM o use uno asociado a su Cuenta de AWS. Para obtener más información, consulte [Creación de un usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console) y [Descripción general de las políticas de AWS IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html) en la Guía del usuario de *IAM*. 1. Conceda al usuario de IAM acceso a. CodeArtifact + **Opción 1:** crear una política de IAM personalizada. Con una política de IAM personalizada, puede proporcionar los permisos mínimos necesarios y cambiar la duración de los tokens de autenticación. Para obtener más información y políticas de ejemplo, consulte [Ejemplos de políticas basadas en la identidad para AWS CodeArtifact](security_iam_id-based-policy-examples.md). + **Opción 2:** utilizar la política `AWSCodeArtifactAdminAccess` AWS gestionada. El siguiente fragmento muestra el contenido de esta política. **importante** Esta política otorga acceso a todos CodeArtifact APIs. Le recomendamos que utilice siempre los permisos mínimos necesarios para realizar la tarea. Para obtener más información, consulte [Prácticas recomendadas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) en la *Guía del usuario de IAM*. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "codeartifact:*" ], "Effect": "Allow", "Resource": "*" }, { "Effect": "Allow", "Action": "sts:GetServiceBearerToken", "Resource": "*", "Condition": { "StringEquals": { "sts:AWSServiceName": "codeartifact.amazonaws.com" } } } ] } ``` ------ **nota** El permiso `sts:GetServiceBearerToken` se debe agregar a la política de usuario de IAM o rol. Si bien se puede añadir a una política de recursos de CodeArtifact dominio o repositorio, el permiso no tendrá ningún efecto en las políticas de recursos. El `sts:GetServiceBearerToken` permiso es necesario para llamar a la CodeArtifact `GetAuthorizationToken` API. Esta API devuelve un token que debe usarse cuando se usa un administrador de paquetes, como `npm` o `pip` con CodeArtifact. Para usar un administrador de paquetes con un CodeArtifact repositorio, tu usuario o rol de IAM debe `sts:GetServiceBearerToken` permitirlo, como se muestra en el ejemplo de política anterior. Si no ha instalado el administrador de paquetes o la herramienta de compilación con los que piensa utilizar CodeArtifact, consulte[Instale su administrador de paquetes o herramienta de compilación](getting-started-install-package-manager.md). # Instale su administrador de paquetes o herramienta de compilación Para publicar o consumir paquetes CodeArtifact, debes usar un administrador de paquetes. Hay diferentes administradores de paquetes para cada tipo de paquete. La siguiente lista contiene algunos administradores de paquetes con los que puede usarlos CodeArtifact. Si aún no lo ha hecho, instale los administradores de paquetes para el tipo de paquete que desee usar. + Para npm, utilice la CLI [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) o [pnpm](https://pnpm.io/installation). + Para Maven, utilice [Apache Maven (`mvn`)](https://maven.apache.org/install.html) o [Gradle](https://gradle.org/install/). + Para Python, utilice [pip](https://pip.pypa.io/en/stable/installation/) para instalar paquetes y [twine](https://twine.readthedocs.io/en/stable/#installation) para publicar paquetes. + [Para NuGet ello, utilice el [Toolkit for Visual](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/setup.html) Studio en Visual Studio o nuget o [dotnet](https://learn.microsoft.com/en-us/nuget/reference/nuget-exe-cli-reference).](https://learn.microsoft.com/en-us/dotnet/core/install/) CLIs + En el caso de los paquetes [genéricos](using-generic.md), utilice la [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) o el SDK para publicar y descargar el contenido del paquete. ## Siguientes pasos Los siguientes pasos dependerán del tipo o tipos de paquete que utilice y del estado de sus recursos. CodeArtifact CodeArtifact Si va a empezar CodeArtifact por primera vez para usted, su equipo o su organización, consulte la siguiente documentación para obtener información general de introducción y ayuda para crear los recursos que necesitará. + [Primeros pasos con la consola](getting-started-console.md) + [Primeros pasos con AWS CLI](getting-started-cli.md) Si sus recursos ya se han creado y está preparado para configurar su administrador de paquetes para enviar paquetes a un CodeArtifact repositorio o instalarlos desde él, consulte la documentación correspondiente a su tipo de paquete o administrador de paquetes. + [Uso de CodeArtifact con npm](using-npm.md) + [Uso CodeArtifact con Python](using-python.md) + [Uso de CodeArtifact con Maven](using-maven.md) + [Uso de CodeArtifact con NuGet](using-nuget.md) + [Uso CodeArtifact con paquetes genéricos](using-generic.md)