Configuración y uso de npm - Amazon CodeCatalyst
Configuración de npm con CodeCatalystInstalación de paquetes npm desde un repositorio de paquetes de CodeCatalystInstalación de paquetes npm desde npmjs a través de CodeCatalystPublicación de paquetes npm en un repositorio de paquetes de CodeCatalystsoporte de comandos npm

Amazon CodeCatalyst ya no está disponible para nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cómo migrar de CodeCatalyst.

Configuración y uso de npm

Para usar npm con CodeCatalyst, debe conectar npm al repositorio de paquetes y proporcionar un token de acceso personal (PAT) para la autenticación. Puede consultar las instrucciones para conectar npm a un repositorio de paquetes en la consola de CodeCatalyst.

Configuración de npm con CodeCatalyst

En las siguientes instrucciones, se explica cómo autenticar y conectar npm al repositorio de paquetes de CodeCatalyst. Para obtener más información sobre npm, consulte la documentación oficial de npm.

Conexión de npm al repositorio de paquetes de CodeCatalyst

  1. Abra la consola de CodeCatalyst en https://codecatalyst.aws/.

  2. Vaya a su proyecto.

  3. En el panel de navegación, elija Paquetes.

  4. Seleccione el repositorio de paquetes de la lista.

  5. Seleccione Establecer conexión con el repositorio.

  6. En Detalles de configuración, en Cliente administrador de paquetes, seleccione cliente npm.

  7. Seleccione su sistema operativo para ver los pasos de configuración correspondientes.

  8. Necesitará un token de acceso personal (PAT) para autenticar npm con CodeCatalyst. Si ya tiene un token, puede usarlo. Si no es así, puede crear uno mediante los siguientes pasos.

    1. (Opcional): actualice el Nombre de PAT y la Fecha de vencimiento.

    2. Seleccione Crear token.

    3. Copie y almacene el PAT en un lugar seguro.

      aviso

      Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT. Las credenciales deben ser de corta duración para minimizar el tiempo durante el que un atacante puede utilizarlas tras apropiarse indebidamente de ellas.

  9. Ejecute los siguientes comandos desde el directorio raíz del proyecto para configurar npm con su repositorio de paquetes. Los comandos harán lo siguiente:

    • Crear un archivo .npmrc en el nivel de proyecto (si el proyecto no tiene uno).

    • Añadir información de punto de conexión del repositorio de paquetes al archivo .npmrc en el nivel de proyecto.

    • Añadir sus credenciales (PAT) al archivo .npmrc en el nivel de usuario.

    Reemplace los siguientes valores.

    nota

    Si va a copiar las instrucciones de la consola, debe actualizar los valores de los siguientes comandos; luego, no será necesario cambiarlos.

    • Sustituya username por su nombre de usuario en CodeCatalyst.

    • Sustituya PAT por su PAT en CodeCatalyst.

    • Sustituya space_name por el nombre de su espacio de CodeCatalyst.

    • Sustituya proj_name por el nombre de su proyecto de CodeCatalyst.

    • Sustituya repo_name por el nombre de su repositorio de paquetes de CodeCatalyst.

    npm set registry=https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/ --location project
npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:_authToken=username:PAT

    Para npm 6 o versiones anteriores: para que npm siempre pase el token de autenticación a CodeCatalyst, incluso para solicitudes GET, defina la variable de configuración always-auth con npm config set de la siguiente manera.

    npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:always-auth=true --location project

Instalación de paquetes npm desde un repositorio de paquetes de CodeCatalyst

Después de conectar npm a su repositorio siguiendo los pasos indicados en Configuración de npm con CodeCatalyst, puede ejecutar comandos npm en su repositorio.

Puede instalar un paquete de npm que esté en el repositorio de paquetes de CodeCatalyst, o en uno de sus repositorios ascendentes, con el comando npm install.

npm install lodash

Instalación de paquetes npm desde npmjs a través de CodeCatalyst

Puede instalar paquetes npm desde npmjs.com a través de un repositorio de CodeCatalyst configurando el repositorio con una conexión ascendente al repositorio de puerta de enlace conectado a npmjs.com (npm-public-registry-gateway). Los paquetes instalados desde npmjs se ingieren y almacenan en el repositorio de puerta de enlace y en el repositorio de paquetes descendentes más alejado.

Instalación de paquetes desde npmjs

  1. Si aún no lo ha hecho, configure npm con el repositorio de paquetes de CodeCatalyst siguiendo los pasos indicados en Configuración de npm con CodeCatalyst.

  2. Compruebe que el repositorio haya añadido el repositorio de puerta de enlace npm-public-registry-gateway como conexión ascendente. Puede comprobar qué orígenes ascendentes se han añadido, o añadir npm-public-registry-gateway como origen ascendente, siguiendo las instrucciones en Adición de un repositorio ascendente y seleccionando el repositorio npm-public-registry-gateway.

  3. Instale los paquetes con el comando npm install.

    npm install package_name

Para obtener más información sobre cómo solicitar paquetes desde repositorios ascendentes, consulte Solicitar una versión de paquete con repositorios ascendentes.

Publicación de paquetes npm en un repositorio de paquetes de CodeCatalyst

Cuando haya terminado Configuración de npm con CodeCatalyst, puede ejecutar los comandos npm.

Puede publicar un paquete npm en un repositorio de paquetes de CodeCatalyst con el comando npm publish.

npm publish

Para obtener información sobre cómo crear paquetes npm, consulte Creating Node.js Modules en npm Docs.

soporte de comandos npm

Las siguientes secciones resumen los comandos npm admitidos por los repositorios de paquetes de CodeCatalyst, además de los comandos específicos que no son compatibles.

Comandos compatibles que interactúan con un repositorio de paquetes

En esta sección, se enumeran los comandos npm en los que el cliente de npm realiza una o más solicitudes al registro con el que se ha configurado (por ejemplo, npm config set registry). Se ha comprobado que estos comandos funcionan correctamente cuando se invocan en un repositorio de paquetes de CodeCatalyst.

Comando Descripción

errores

Intenta adivinar la ubicación de la URL del rastreador de errores de un paquete y trata de abrirla.

ci

Instala un proyecto desde cero.

deprecate

Deja en desuso una versión de un paquete.

dist-tag

Modifica las etiquetas de distribución de paquetes.

docs

Intenta adivinar la ubicación de la URL de la documentación de un paquete y trata de abrirla mediante el parámetro de configuración --browser.

doctor

Ejecuta una serie de comprobaciones para validar que la instalación de npm pueda administrar los paquetes de JavaScript.

install

Instala un paquete.

install-ci-test

Instala un proyecto desde cero y ejecuta pruebas. Alias: npm cit. Este comando ejecuta un npm ci seguido inmediatamente por un npm test.

install-test

Instala el paquete y ejecuta las pruebas. Ejecuta un npm install seguido inmediatamente por un npm test.

outdated

Comprueba el registro configurado para ver si alguno de los paquetes instalados está desactualizado.

ping

Hace ping al registro npm configurado o dado y verifica la autenticación.

publish

Publica una versión del paquete en el registro.

update

Intenta adivinar la ubicación de la URL del repositorio de un paquete y trata de abrirla mediante el parámetro de configuración --browser.

view

Muestra metadatos del paquete. También se puede usar para imprimir las propiedades de los metadatos.

Comandos del lado del cliente compatibles

Estos comandos no requieren ninguna interacción directa con un repositorio de paquetes, por lo que CodeCatalyst no necesita nada para darles soporte.

Comando Descripción

bin (heredado)

Muestra el directorio bin de npm.

build

Crea un paquete.

cache

Manipula la caché de paquetes.

completion

Permite completar tabulaciones en todos los comandos de npm.

config

Actualiza el contenido de los archivos npmrc globales y de usuario.

dedupe

Busca en el árbol de paquetes local e intenta simplificar la estructura moviendo las dependencias más arriba en el árbol, donde pueden compartirse de manera más eficaz entre varios paquetes dependientes.

edit

Edita un paquete instalado. Selecciona una dependencia en el directorio de trabajo actual y abre el directorio del paquete en el editor predeterminado.

explore

Busca un paquete instalado. Genera una subshell en el directorio del paquete instalado especificado. Si se especifica un comando, se ejecuta en la subshell, que finaliza inmediatamente.

ayuda

Obtiene ayuda sobre npm.

help-search

Busca en la documentación de ayuda de npm.

init

Crea un archivo package.json.

link

Enlaza simbólicamente un directorio de paquetes.

ls

Muestra los paquetes instalados.

pack

Crea un tarball a partir de un paquete.

prefix

Muestra un prefijo. Este es el directorio principal más cercano que contiene un archivo package.json, a menos que también se especifique -g.

prune

Elimina los paquetes que no figuran en la lista de dependencias del paquete principal.

rebuild

Ejecuta el comando npm build en las carpetas coincidentes.

restart

Ejecuta los scripts de parada, reinicio e inicio de un paquete, así como los scripts previos y posteriores asociados.

root

Imprime el directorio node_modules efectivo en formato estándar.

run-script

Ejecuta scripts de paquetes arbitrarios.

shrinkwrap

Bloquea las versiones dependientes para su publicación.

uninstall

Desinsta un paquete.

Comandos admitidos

Estos comandos npm no son compatibles con los repositorios de paquetes de CodeCatalyst.

Comando Descripción Notas

access

Establece el nivel de acceso de los paquetes publicados.

CodeCatalyst usa un modelo de permisos diferente del repositorio público npmjs.

adduser

Añade una cuenta de usuario de registro

CodeCatalyst usa un modelo de usuario diferente del repositorio público npmjs.

audit

Realiza una auditoría de seguridad.

CodeCatalyst no vende actualmente datos sobre vulnerabilidades de seguridad.

hook

Administra los enlaces npm, lo que incluye agregar, eliminar, enumerar y actualizar.

CodeCatalyst no admite actualmente ningún tipo de mecanismo de notificación de cambios.

login

Autentica a un usuario. Este es un alias para npm adduser.

CodeCatalyst utiliza un modelo de autenticación diferente del repositorio público npmjs. Para obtener más información, consulte Configuración de npm con CodeCatalyst.

logout

Cierra la sesión del registro.

CodeCatalyst utiliza un modelo de autenticación diferente del repositorio público npmjs. No hay forma de cerrar sesión en un repositorio de CodeCatalyst, pero los tokens de autenticación vencen después del tiempo de caducidad configurable. La duración predeterminada del token es de 12 horas.

owner

Administra a los propietarios de los paquetes.

CodeCatalyst usa un modelo de permisos diferente del repositorio público npmjs.

profile

Cambia la configuración de su perfil de registro.

CodeCatalyst usa un modelo de usuario diferente del repositorio público npmjs.

search

Busca en el registro paquetes que coincidan con los términos de búsqueda.

CodeCatalyst no admite el comando search.

star

Marca sus paquetes favoritos.

Actualmente, CodeCatalyst no admite ningún mecanismo de favoritos.

stars

Visualiza los paquetes marcados como favoritos.

Actualmente, CodeCatalyst no admite ningún mecanismo de favoritos.

team

Administra los equipos y las pertenencias a estos.

CodeCatalyst utiliza un modelo de pertenencia de usuarios y grupos diferente del repositorio público npmjs.

token

Administra sus tokens de autenticación.

CodeCatalyst usa un modelo diferente para obtener los tokens de autenticación. Para obtener más información, consulte Configuración de npm con CodeCatalyst.

unpublish

Elimina un paquete del registro.

CodeCatalyst no admite la eliminación de una versión de paquete desde un repositorio mediante el cliente de npm. Puede eliminar un paquete en la consola.

whoami

Muestra el nombre de usuario de npm.

CodeCatalyst usa un modelo de usuario diferente del repositorio público npmjs.