Tutorial: Extracción de un repositorio de paquetes

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

Vaya a su proyecto codecatalyst-package-project.

En el panel de navegación, elija Código y, a continuación, elija Repositorios de origen.

Elija Agregar repositorio y, a continuación, elija Crear repositorio.

En Nombre del repositorio, escriba:

hello-world-app

Seleccione Crear.

En el panel de navegación, elija Packages (Paquetes).

Seleccione Crear repositorio de paquetes.

En Nombre del repositorio, escriba:

codecatalyst-package-repository

Elija + Seleccionar repositorios ascendentes.

Seleccione Repositorios de puerta de enlace.

En el cuadro npm-public-registry-gateway, seleccione Crear.

Elija Seleccionar.

Seleccione Crear.

CodeCatalyst crea un repositorio de paquetes denominado codecatalyst-package-repository, que está conectado a un repositorio de puerta de enlace. El repositorio de puerta de enlace está conectado al registro npmjs.com.

En el panel de navegación, elija Código y, a continuación, Entornos de desarrollo.

Cerca de la parte superior, elija Crear entorno de desarrollo y, a continuación, elija AWS Cloud9 (en el navegador).

Asegúrese de que Repositorio se haya configurado como hello-world-app y que Ramificación existente se haya configurado como main. Seleccione Crear.

El entorno de desarrollo se abrirá en una nueva pestaña del navegador y el repositorio (hello-world-app) se clonará en este.

Deje abiertas las dos pestañas del navegador de CodeCatalyst y vaya al siguiente procedimiento.

Vaya a su entorno de desarrollo.

En la línea de comandos del terminal, cambie al directorio raíz del repositorio de código fuente de hello-world-app.

cd hello-world-app

Inicialice un proyecto de Node.js:

npm init -y

La inicialización crea un archivo package.json en el directorio raíz de hello-world-app.

Conecte el cliente npm del entorno de desarrollo al repositorio de paquetes de CodeCatalyst:

Importe la versión 4.17.20 de lodash:

npm install lodash@v4.17.20 --save --save-exact

npm busca la versión 4.17.20 de lodash en las siguientes ubicaciones y en el siguiente orden:

npm importa lodash al repositorio de puerta de enlace, al repositorio de paquetes de CodeCatalyst y al entorno de desarrollo.

npm también actualiza el archivo package.json con la dependencia lodash y crea un directorio node_modules que contiene lodash y todas sus dependencias.

Compruebe que lodash se haya importado correctamente a su entorno de desarrollo. Escriba:

npm list

Aparecerá el siguiente mensaje que indica que la importación se ha realizado correctamente:

`-- lodash@4.17.20

(Opcional) Abra hello-world-app/package.json y compruebe que se hayan añadido las líneas en rojo y en negrita:

{
  "name": "hello-world-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  dependencies": {
    "lodash": "4.17.20"
  }
}

En /hello-world-app, cree un archivo llamado index.js con el siguiente contenido:

// Importing lodash library
const _ = require('lodash');

// Input string
const inputString = 'hello-world';

// Transforming the string using lodash
const transformedString = _.startCase(inputString.replace('-', ' '));

// Outputting the transformed string to the console
console.log(transformedString);

Cambie a la consola de CodeCatalyst.

En el panel de navegación, elija Packages (Paquetes).

Seleccione npm-public-registry-gateway.

Asegúrese de que aparezca lodash. La columna Última versión indica 4.17.20.

Repita este procedimiento para el codecatalyst-package-repository. Puede que tenga que actualizar la ventana del navegador para ver el paquete importado.

Cambie a su entorno de desarrollo.

Compruebe que aún se encuentra en el directorio hello-world-app y ejecute la aplicación:

node index.js

Aparecerá un mensaje Hello World. Node.js ejecutó la aplicación con el paquete lodash que ha descargado en el entorno de desarrollo en un paso anterior.

Ignore el directorio node_modules. Escriba:

echo "node_modules/" >> .gitignore

Es recomendable evitar confirmar este directorio. Además, confirmar este directorio interferirá con pasos futuros en este tutorial.

Añada, confirme y envíe:

git add .
git commit -m "add the Hello World application"
git push

Los archivos de la aplicación y del proyecto “Hola, mundo” se añaden al repositorio de código fuente.

Cambie a la consola de CodeCatalyst.

En el panel de navegación, elija CI/CD y, a continuación, elija Flujos de trabajo.

Seleccione Crear flujo de trabajo.

En Repositorio de origen, elija hello-world-app.

En Ramificación, elija main.

El archivo de definición del flujo de trabajo se creará en el repositorio y la ramificación de origen elegidos.

Seleccione Crear.

Seleccione YAML cerca de la parte superior.

Elimine el código de ejemplo de YAML.

Añada el código de YAML siguiente:

Name: codecatalyst-package-workflow
SchemaVersion: "1.0"

# Required - Define action configurations.
Actions:
  RunHelloWorldApp:
    # Identifies the action. Do not modify this value.
    Identifier: aws/build@v1
    Compute:
      Type: Lambda
    Inputs:
      Sources:
        - WorkflowSource # This specifies your source repository. 
    Configuration:
      Steps:
        - Run: npm install
        - Run: npm list
        - Run: node index.js
      Container: # This specifies the Docker image that runs the action.
        Registry: CODECATALYST
        Image: CodeCatalystLinuxLambda_x86_64:2024_03
    Packages:
      NpmConfiguration:
        PackageRegistries:
          - PackagesRepository: codecatalyst-package-repository

En el código anterior, sustituya codecatalyst-package-repository por el nombre del repositorio de paquetes de CodeCatalyst que creó en Paso 2: crear los repositorios de paquetes de puertas de enlace y de CodeCatalyst.

Para obtener información sobre las propiedades de este archivo, consulte el Acciones de compilación y prueba de YAML.

(Opcional) Seleccione Validar para asegurarse de que el código de YAML del flujo de trabajo es válido antes de confirmarlo.

Elija Commit (Confirmar).

En el cuadro de diálogo Confirmar flujo de trabajo, escriba lo siguiente:

1. En Nombre del archivo de flujo de trabajo, deje el valor predeterminado, codecatalyst-package-workflow.

2. En Mensaje de confirmación, escriba:

   add initial workflow file

3. En Repositorio, seleccione hello-world-app.

4. En Nombre de la ramificación, elija principal.

5. Elija Commit (Confirmar).

Ahora ha creado un flujo de trabajo.

Junto al flujo de trabajo que acaba de crear (codecatalyst-package-workflow), seleccione Acciones y, a continuación, Ejecutar.

Se inicia una ejecución de flujo de trabajo.

En la notificación verde de la parte superior, a la derecha, seleccione el enlace a la ejecución. El enlace tiene un aspecto similar a View Run-1234.

Aparecerá un diagrama de flujo de trabajo que muestra quién inició la ejecución y la acción RunHelloWorldApp.

Seleccione la casilla de acción RunHelloWorldApp para ver el progreso de la acción.

Cuando termine la ejecución, vaya a Paso 5: verificar el flujo de trabajo.

En el diagrama de flujo de trabajo, selecciona la casilla RunHelloWorldApp.

Aparecerá una lista de mensajes de registro.

Amplíe el mensaje de registro node index.js.

Aparecerá el siguiente mensaje:

[Container] 2024/04/24 21:15:41.545650 Running command node index.js
Hello World

La aparición de Hello Word (en lugar de hello-world) indica que la dependencia lodash se ha empleado correctamente.

Amplíe el registro npm list.

Aparecerá un mensaje similar al siguiente:

└── lodash@4.17.20

Este mensaje indica que la versión 4.17.20 de lodash se descargó en la imagen de Docker que ejecutaba la acción del flujo de trabajo.

En el panel de navegación, elija Packages (Paquetes).

Seleccione npm-publish-registry-gateway.

Elija lodash.

Cerca de la parte superior, seleccione Controles de origen.

En Ascendente, seleccione Bloquear.

Seleccione Guardar.

Ahora, ha bloqueado las importaciones al repositorio de puerta de enlace (y a los repositorios y ordenadores descendentes) desde npmjs.com.

Cambie a su entorno de desarrollo.

Extraiga el archivo codecatalyst-package-workflow.yaml que creó anteriormente con la consola de CodeCatalyst:

git pull

Abra /hello-world-app/package.json.

Cambie la versión de lodash a 4.17.21, como se muestra en rojo y negrita:

{
  "name": "hello-world-app",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "lodash": "4.17.21"
  }
}

Ahora, hay una discrepancia entre la versión en el archivo package.json (4.17.21) y la versión en los repositorios de paquetes de CodeCatalyst y de puerta de enlace (4.17.20).

Añada, confirme y envíe:

git add .
git commit -m "update package.json to use lodash 4.17.21"
git push

Ejecute el flujo de trabajo con la discrepancia de versiones:

Compruebe que ha habido un error en el flujo de trabajo:

En el panel de navegación, elija Packages (Paquetes).

Seleccione npm-publish-registry-gateway.

Elija lodash.

Cerca de la parte superior, seleccione Controles de origen.

En Ascendente, selecciona Permitir.

Seleccione Guardar.

Ahora, ha desbloqueado las importaciones de lodash.

Ahora, el flujo de trabajo puede importar la versión 4.17.21 de lodash.

Ejecute el flujo de trabajo de nuevo. Esta vez, el flujo de trabajo debería funcionar correctamente porque la importación de la versión 4.17.21 debería ocurrir. Para ejecutar el flujo de trabajo de nuevo:

Compruebe que la versión 4.17.21 se haya importado en los repositorios de CodeCatalyst y puerta de enlace:

Elimine codecatalyst-package-project:

1. En la consola de CodeCatalyst, vaya al proyecto codecatalyst-package-project si no está ya allí.

2. En el panel de navegación, seleccione Configuración del proyecto.

3. Elija Eliminar proyecto, introduzca delete y elija Eliminar proyecto.

   CodeCatalyst elimina todos los recursos del proyecto, incluidos los repositorios de paquetes de CodeCatalyst, de puerta de enlace y de origen. También se elimina el entorno de desarrollo.

Elimine el token (PAT):

1. Elija el nombre de usuario, a la derecha y seleccione Mi configuración.

2. En Tokens de acceso personal, seleccione el token que ha creado en este tutorial y, luego, elija Eliminar.