Tutorial: Extracción de un repositorio de paquetes

Abra la CodeCatalyst consola 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 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 npm-public-registry-gatewaycuadro, selecciona 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 CodeCatalyst del navegador y continúe con el 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 de su entorno de desarrollo a su repositorio de CodeCatalyst paquetes:

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 la puerta de enlace, al repositorio de CodeCatalyst paquetes 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) Abre hello-world-app/package.json y verifica que se hayan agregado las líneas: red bold

{
  "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. CodeCatalyst

En el panel de navegación, elija Paquetes.

Elija 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. 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 código fuente, 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, codecatalyst-package-repository sustitúyalo por el nombre del repositorio de CodeCatalyst paquetes en el que lo creastePaso 2: Cree los repositorios de paquetes CodeCatalyst y gateway.

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 sea válido antes de confirmarlo.

Elija 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, elija hello-world-app.

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

5. Elija 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.

Aparece un diagrama de flujo de trabajo que muestra quién inició la ejecución y la RunHelloWorldAppacción.

Selecciona la casilla de RunHelloWorldAppacción para ver el progreso de la acción.

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

En el diagrama de flujo de trabajo, selecciona la RunHelloWorldAppcasilla.

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 Paquetes.

Elija 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 codecatalyst-package-workflow.yaml archivo que creó anteriormente con la CodeCatalyst consola:

git pull

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

Cambie la lodash versión a la 4.17.21 como se muestra en: red bold

{
  "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 del package.json archivo (4.17.21) y la versión de los repositorios de CodeCatalyst paquetes y de la 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 Paquetes.

Elija npm-publish-registry-gateway.

Elija lodash.

Cerca de la parte superior, seleccione Controles de origen.

En Ascendente, seleccione 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 a sus repositorios CodeCatalyst y a los de Gateway:

Elimine codecatalyst-package-project:

1. En la CodeCatalyst consola, navegue hasta el codecatalyst-package-project proyecto si aún no está 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 código fuente, puerta de enlace y CodeCatalyst paquetes. 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.