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.
Puede usar herramientas de CLI como nuget y dotnet para publicar y consumir paquetes desde CodeArtifact. Este documento proporciona información sobre la configuración de las herramientas CLI y su uso para publicar o consumir paquetes.
Temas
Configurar la CLI de nuget o dotnet
Puede configurar la CLI de nuget o dotnet con el proveedor de CodeArtifact NuGet credenciales, con o manualmente AWS CLI. Se recomienda encarecidamente NuGet realizar la configuración con el proveedor de credenciales para simplificar la configuración y continuar con la autenticación.
Método 1: configure con el proveedor de CodeArtifact NuGet credenciales
El proveedor de CodeArtifact NuGet credenciales simplifica la autenticación y la configuración con herramientas CodeArtifact NuGet CLI. CodeArtifact los tokens de autenticación son válidos durante un máximo de 12 horas. Para evitar tener que actualizar manualmente el token mientras se usa la CLI nuget o dotnet, el proveedor de credenciales busca periódicamente un nuevo token antes de que caduque el token actual.
importante
Para usar el proveedor de credenciales, asegúrese de borrar del nuget.config archivo todas AWS CodeArtifact las credenciales existentes que se hayan agregado manualmente o ejecutándolas aws codeartifact login para configurarlas NuGet previamente.
Instale y configure el proveedor de CodeArtifact NuGet credenciales
Descargue la versión más reciente de AWS. CodeArtifact. NuGet. CredentialProvider herramienta de NuGet .org
con el siguiente dotnetcomando.dotnet tool install -g AWS.CodeArtifact.NuGet.CredentialProvider-
Use el
codeartifact-creds installcomando para copiar el proveedor de credenciales a la carpeta de NuGet complementos.dotnet codeartifact-creds install -
(Opcional): establece el AWS perfil que quieres usar con el proveedor de credenciales. Si no se establece, el proveedor de credenciales utilizará el perfil predeterminado. Para obtener más información sobre AWS CLI los perfiles, consulte Perfiles con nombre.
dotnet codeartifact-creds configure set profileprofile_name
Después de crear un repositorio y configurar el proveedor de credenciales, puede usar las herramientas de la CLI nuget o dotnet para instalar y publicar paquetes. Para obtener más información, consulte Consume paquetes NuGet de CodeArtifact y Publica NuGet paquetes en CodeArtifact.
Método 2: configurar nuget o dotnet con el comando login
El codeartifact login comando del AWS CLI añade un punto final del repositorio y un token de autorización a tu archivo de NuGet configuración, lo que permite que nuget o dotnet se conecten a tu CodeArtifact repositorio. Esto modificará la NuGet configuración a nivel de usuario, que se encuentra en %appdata%\NuGet\NuGet.Config Windows ~/.config/NuGet/NuGet.Config o ~/.nuget/NuGet/NuGet.Config Mac/Linux. Para obtener más información sobre NuGet las configuraciones, consulte Configuraciones comunes. NuGet
Configurar nuget o dotnet con el comando login
-
Configure sus AWS credenciales para usarlas con AWS CLI, tal y como se describe enEmpezar con CodeArtifact.
-
Asegúrese de que la herramienta NuGet CLI (
nugetodotnet) se haya instalado y configurado correctamente. Para obtener instrucciones, consulte la documentación de nugeto dotnet . -
Use el CodeArtifact
logincomando para obtener las credenciales para usarlas con NuGet.nota
Si va a acceder a un repositorio de un dominio de su propiedad, no tiene que incluir
--domain-owner. Para obtener más información, consulte Dominios entre cuentas.importante
Usuarios de Linux y macOS: dado que el cifrado no es compatible con plataformas que no son de Windows, las credenciales recuperadas se almacenarán como texto sin formato en el archivo de configuración.
aws codeartifact login --tooldotnet--domainmy_domain--domain-owner111122223333--repositorymy_repo
El comando de inicio de sesión hará lo siguiente:
-
Obtenga un token de autorización CodeArtifact utilizando sus credenciales. AWS
-
Actualice su NuGet configuración a nivel de usuario con una nueva entrada para la fuente NuGet del paquete. Se
domain_name/repo_name
El período de autorización predeterminado después de una llamada login es de 12 horas y login debe invocarse para actualizar periódicamente el token. Para obtener más información sobre el token de autorización creado con el comando login, consulte Tokens creados con el comando login.
Después de crear un repositorio y configurar la autenticación, puede utilizar los clientes CLI nuget, dotnet o msbuild para instalar y publicar paquetes. Para obtener más información, consulte Consume paquetes NuGet de CodeArtifact y Publica NuGet paquetes en CodeArtifact.
Método 3: configurar nuget o dotnet sin el comando login
Para la configuración manual, debe añadir un punto final del repositorio y un token de autorización al archivo de NuGet configuración para permitir que nuget o dotnet se conecten a su CodeArtifact repositorio.
Configura manualmente nuget o dotnet para que se conecten a tu repositorio. CodeArtifact
-
Determine el punto final de su CodeArtifact repositorio mediante el
get-repository-endpointAWS CLI comando.aws codeartifact get-repository-endpoint --domainmy_domain--domain-owner111122223333--repositorymy_repo--format nugetEjemplo de salida:
{ "repositoryEndpoint": "https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/nuget/my_repo/" } -
Obtén un token de autorización para conectarte a tu repositorio desde tu administrador de paquetes mediante el
get-authorization-tokenAWS CLI comando.aws codeartifact get-authorization-token --domainmy_domainEjemplo de salida:
{ "authorizationToken": "eyJ2I...viOw", "expiration": 1601616533.0 } -
Crea la URL completa del punto de conexión del repositorio agregando
/v3/index.jsona la URL devuelta porget-repository-endpointen el paso 3. Configure nuget o dotnet para usar el punto de conexión del repositorio del paso 1 y el token de autorización del paso 2.
nota
/v3/index.jsonPara que nuget o dotnet se conecten correctamente a un CodeArtifact repositorio, la URL de origen debe terminar en.Usuarios de Linux y macOS: dado que el cifrado no se admite en plataformas que no sean Windows, debe añadir la marca
--store-password-in-clear-textal siguiente comando. Tenga en cuenta que esto almacenará la contraseña como texto sin formato en el archivo de configuración.dotnet nuget add source https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/nuget/my_repo/v3/index.json --namepackageSourceName--passwordeyJ2I...viOw--username awsnota
Para actualizar una fuente existente, utilice el comando
dotnet nuget update source.Ejemplo de salida:
Package source with Name:domain_name/repo_nameadded successfully.nota
Para usar un punto final de doble pila, use el punto final.
codeartifact.region.on.aws
Consume paquetes NuGet de CodeArtifact
Una vez que lo haya configurado NuGet CodeArtifact, podrá consumir NuGet los paquetes que estén almacenados en su CodeArtifact repositorio o en uno de sus repositorios ascendentes.
Para consumir una versión de paquete de un CodeArtifact repositorio o de uno de sus repositorios ascendentes con nuget odotnet, ejecute el siguiente comando sustituyéndola por packageName el nombre del paquete que desee consumir y packageSourceName por el nombre de origen del CodeArtifact repositorio en el archivo de configuración. NuGet Si usó el login comando para configurar la NuGet configuración, el nombre de la fuente es. domain_name/repo_name
nota
Cuando se solicita un paquete, el NuGet cliente almacena en caché las versiones de ese paquete que existen. Debido a este comportamiento, es posible que se produzca un error en la instalación de un paquete que se solicitó anteriormente antes de que la versión deseada estuviera disponible. Para evitar este error e instalar correctamente un paquete existente, puede borrar la NuGet memoria caché antes de realizar la instalación con nuget locals all --clear o dotnet nuget locals all --clear bien evitar el uso de la memoria caché durante restore los comandos install y proporcionando la -NoCache opción for nuget o la --no-cache opción fordotnet.
dotnet add packagepackageName--sourcepackageSourceName
Para instalar una versión específica de un paquete
dotnet add packagepackageName--version1.0.0--sourcepackageSourceName
Consulte Administrar paquetes mediante la CLI nuget.exe
Consume NuGet paquetes de NuGet .org
Puede consumir NuGet paquetes de NuGet.org
Publica NuGet paquetes en CodeArtifact
Una vez que lo haya configurado NuGet CodeArtifact, puede usar nuget o publicar las versiones de dotnet los paquetes en los repositorios. CodeArtifact
Para enviar una versión de paquete a un CodeArtifact repositorio, ejecute el siguiente comando con la ruta completa del .nupkg archivo y el nombre de la fuente del CodeArtifact repositorio en el archivo de NuGet configuración. Si usó el login comando para configurar la NuGet configuración, el nombre de la fuente esdomain_name/repo_name.
nota
Puede crear un NuGet paquete si no tiene uno para publicar. Para obtener más información, consulte el flujo de trabajo de creación de paquetes
dotnet nuget pushpath/to/nupkg/SamplePackage.1.0.0.nupkg--sourcepackageSourceName
CodeArtifact NuGet Referencia del proveedor de credenciales
El proveedor de CodeArtifact NuGet credenciales facilita la configuración y la autenticación NuGet en sus repositorios. CodeArtifact
CodeArtifact NuGet Comandos del proveedor de credenciales
En esta sección se incluye la lista de comandos del proveedor de CodeArtifact NuGet credenciales. Estos comandos deben tener el prefijo dotnet codeartifact-creds como en el siguiente ejemplo.
dotnet codeartifact-credscommand
configure set profile: configura el proveedor de credenciales para que utilice el perfil proporcionado. AWSprofileconfigure unset profile: elimina el perfil configurado si está establecido.install: copia el proveedor de credenciales en la carpetaplugins.install --profile: copia el proveedor de credenciales en laprofilepluginscarpeta y lo configura para que utilice el perfil proporcionado. AWSuninstall: desinstala el proveedor de credenciales. Esto no elimina los cambios en el archivo de configuración.uninstall --delete-configuration: desinstala el proveedor de credenciales y elimina todos los cambios en el archivo de configuración.
CodeArtifact NuGet Registros del proveedor de credenciales
Para habilitar el registro para el proveedor de CodeArtifact NuGet credenciales, debe configurar el archivo de registro en su entorno. Los registros del proveedor de credenciales contienen información de depuración útil, como:
-
El AWS perfil utilizado para realizar las conexiones
-
Cualquier error de autenticación
-
Si el punto final proporcionado no es una CodeArtifact URL
Configure el archivo de registro del proveedor de CodeArtifact NuGet credenciales
export AWS_CODEARTIFACT_NUGET_LOGFILE=/path/to/file
Una vez configurado el archivo de registro, cualquier comando codeartifact-creds añadirá su salida de registro al contenido de ese archivo.
CodeArtifact NuGet Versiones del proveedor de credenciales
La siguiente tabla contiene información sobre el historial de versiones y enlaces de descarga del proveedor de CodeArtifact NuGet credenciales.
| Versión | Cambios | Fecha de publicación | Enlace de descarga (S3) |
|---|---|---|---|
|
1.0.2 (más reciente) |
Dependencias actualizadas |
26/06/2024 |
|
|
1.0.1 |
Se agregó soporte para los perfiles net5, net6 y SSO |
05/03/2022 |
|
|
1.0.0 |
Versión inicial de CodeArtifact NuGet Credential Provider |
20 de noviembre de 2020 |
