Configure el proyecto y conéctese a Azure Artifacts

Artículo
11/29/2021
Tiempo de lectura: 5 minutos

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Con Azure Artifacts, puede publicar diferentes tipos de paquetes en las fuentes, como paquetes npm, NuGet, Python, Maven y Universal. También puede instalar paquetes desde fuentes y registros públicos, como npmjs.com.

Para autenticarse con Azure Artifacts, primero debemos configurar el archivo de configuración. npm usa archivos de configuración .npmrc para almacenar las direcciones URL y las credenciales de fuente.

Configuración del proyecto

Se recomienda usar dos .npmrc_, el primero que usaremos para autenticarse en Azure Artifacts y el segundo debe conservarse localmente para almacenar nuestras credenciales. Esto le permite compartir el archivo .npmrc del proyecto mientras mantiene sus credenciales seguras.

Seleccione Artifactsy, a continuación, seleccione Conectar para alimentar.

Seleccione Paquetesy, a continuación, Conectar para alimentar.

Seleccione npm en la lista de tipos de paquetes.
Si es la primera vez que usa Azure Artifacts con npm, seleccione el botón Obtener las herramientas y siga las instrucciones para instalar los requisitos previos.

Siga las instrucciones de la sección Project configuración para configurar el proyecto.

Siga las instrucciones de la sección Project configuración para configurar el proyecto.

Siga las instrucciones para configurar el proyecto.

En la máquina de desarrollo, coloque el segundo archivo .npmrc en la $HOME para Linux/Mac o $env. INICIO para Windows. Este archivo .npmrc debe contener todas las credenciales de los registros.

Configuración de credenciales

Sugerencia

Se admiten varios registros en archivos .npmrc con orígenes y ámbitos ascendentes.

Windows
Linux/Mac

Si está desarrollando en Windows, se recomienda usar para capturar las credenciales e insertarlas en vsts-npm-authvsts-npm-auth. La manera más fácil de configurarlo es instalar vsts-npm-auth globalmente y, a continuación, agregar un script de ejecución a vsts-npm-auth.

Instale vsts-npm-auth globalmente:
```
npm install -g vsts-npm-auth
```

Agregue el script a package.json:

"scripts": {
    "refreshVSToken" : "vsts-npm-auth -config .npmrc"
}

vsts-npm-auth no se admite en Linux o Mac. Siga estos pasos para configurar las credenciales:

Copie el siguiente fragmento de código en el archivo .npmrc.

Fuente con ámbito de organización:

; begin auth token
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Project de ámbito de aplicación:

; begin auth token
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

Genere un token de acceso personal conámbitos de lectura y escritura de empaquetado.
Codifica el token de acceso personal recién generado de la siguiente manera:
1. Ejecute el siguiente comando en una ventana del símbolo del sistema con privilegios elevados y pegue el token de acceso personal cuando se le solicite:
```
node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
```
  También puede usar el siguiente comando para convertir el token de acceso personal a Base64:
  - LinuxMac:
```
echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
```
2. Copie el valor codificado en Base64.
Abra el archivo .npmrc y reemplace el marcador de posición [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] por el token de acceso personal codificado que creó en el paso anterior.

Nota

vsts-npm-authno se admite en TFS ni Azure DevOps Server.

Configuración de la autenticación en la canalización

Hay dos opciones para configurar la autenticación en la canalización:

Sin un ejecutor de tareas.
Con un ejecutor de tareas (por ejemplo, Gulp).

Sin ejecutor de tareas

Para autenticarse con Azure Artifacts desde la canalización sin un ejecutor de tareas, siga estos pasos:

Seleccione Azure Pipelinesy, a continuación, seleccione la definición de canalización.
Seleccione Editar para modificar la canalización.
Seleccione + esta opción para agregar una tarea a la canalización.
Busque la tarea npm y seleccione Agregar para agregarla a la canalización.
Seleccione la carpeta que contiene el archivo package.json.
Expanda la sección Registros y autenticación personalizados y, a continuación, seleccione Registro que selecciono aquí. Seleccione la fuente en el menú desplegable.

Nota

Al seleccionar esta opción, la tarea creará un archivo .npmrc temporal para la fuente seleccionada aquí e invalidará el archivo .npmrc del proyecto.
Seleccione Guardar cola cuando haya terminado.

Seleccione Compilar y liberary, a continuación, seleccione Compilaciones.
Seleccione la canalización y, a continuación, seleccione Editar.
Seleccione + esta opción para agregar una tarea a la canalización.
Busque la tarea npm y seleccione Agregar para agregarla a la canalización.
Seleccione la carpeta que contiene el archivo package.json.
Expanda la sección Registros y autenticación personalizados y, a continuación, seleccione Registro que selecciono aquí. Seleccione la fuente en el menú desplegable.

Nota

Al seleccionar esta opción, la tarea creará un archivo .npmrc temporal para la fuente seleccionada aquí e invalidará el archivo .npmrc del proyecto.
Seleccione Guardar cola cuando haya terminado.

Sugerencia

Para permitir que la canalización acceda a la fuente, asegúrese de establecer el servicio de compilación en un colaborador en la configuración de la fuente. Azure Artifacts : > Seleccione la fuente > - Configuración - Permisos - establezca el rol de servicio de >> compilación en >.

captura de pantalla de sugerencias

Con un ejecutor de tareas

Al usar un ejecutor de tareas, deberá agregar la tarea npm Authenticate al principio de la canalización. Esto insertará sus credenciales en el archivo .npmrc del proyecto y las conservará durante la duración de la ejecución de la canalización. Esto permite que los pasos posteriores usen las credenciales en .npmrc.

Seleccione Azure Pipelinesy, a continuación, seleccione la definición de canalización.
Seleccione Editar para modificar la canalización.
Seleccione + esta opción para agregar una tarea a la canalización.
Busque la tarea npm Authenticate y, a continuación, seleccione Agregar para agregarla a la canalización.
Seleccione el archivo .npmrc.
Seleccione Guardar cola cuando haya terminado.

Seleccione Compilar y liberary, a continuación, seleccione Compilaciones.
Seleccione la canalización y, a continuación, seleccione Editar.
Seleccione + esta opción para agregar una tarea a la canalización.
Busque la tarea npm Authenticate y, a continuación, seleccione Agregar para agregarla a la canalización.
Seleccione el archivo .npmrc.
Seleccione Guardar cola cuando haya terminado.

Solución de problemas

El comando no se reconoce:

Si se está ejecutando el siguiente error:
- Cmd: 'vsts-npm-auth' is not recognized as an internal or external command, operable program or batch file.
- PowerShell: vsts-npm-auth : The term 'vsts-npm-auth' is not recognized as the name of a cmdlet, function, script file, or operable program.
A continuación, es probable que la carpeta npm modules no esté en la ruta de acceso. Para corregir este problema, vuelva a ejecutar el Node.js y asegúrese de que las Add to PATH opciones están seleccionadas.

Como alternativa, puede editar la variable PATH (símbolo del sistema) o %APPDATA%\npm$env:APPDATA\npm (PowerShell) para agregarla a la ruta de acceso.
No se puede autenticar:

Si se encuentra con un error E401: code E401 npm ERR! Unable to authenticate . Ejecute el vsts-npm-auth comando con la marca vsts-npm-auth para volver a autenticar.
```
vsts-npm-auth -config .npmrc -F
```