Tutorial: Extraer de un repositorio de paquetes

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

Navegue hasta 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, ingresa:

hello-world-app

Seleccione Crear.

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

Seleccione Crear repositorio de paquetes.

En Nombre del repositorio, introduzca:

codecatalyst-package-repository

Elija + Seleccione los repositorios originales.

Elija los repositorios de Gateway.

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 la puerta de enlace está conectado al registro npmjs.com.

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

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

Asegúrese de que el repositorio esté configurado hello-world-app como y la rama existente esté configurada comomain. Seleccione Crear.

Tu entorno de desarrollo se abre en una nueva pestaña del navegador y tu repositorio (hello-world-app) se clona en ella.

Deje abiertas las dos pestañas CodeCatalyst del navegador y continúe con el siguiente procedimiento.

Ve a tu entorno de desarrollo.

En la línea de comandos del terminal, cambia al directorio raíz del repositorio de hello-world-app origen:

cd hello-world-app

Inicialice un proyecto de Node.js:

npm init -y

La inicialización crea un package.json archivo 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 lodash la versión 4.17.20:

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

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

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

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

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

npm list

Aparece 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 las líneas red boldse agregaron:

{
  "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 Packages (Paquetes).

Elige npm-public-registry-gateway.

Asegúrese de que lodash se muestre. Lo indica la columna Última versión4.17.20.

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

Cambie a su entorno de desarrollo.

Asegúrese de seguir en el hello-world-app directorio y, a continuación, ejecute la aplicación:

node index.js

Aparece un Hello World mensaje. Node.js ejecutó la aplicación con el lodash paquete que descargó en su entorno de desarrollo en un paso anterior.

node_modulesIgnora el directorio. Introduzca:

echo "node_modules/" >> .gitignore

Se recomienda evitar comprometer este directorio. Además, confirmar este directorio interferirá con los pasos posteriores de este tutorial.

Agrega, confirma y presiona:

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

Los archivos de la aplicación y del proyecto «Hello World» se añaden a tu 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 origen, elijahello-world-app.

Para Branch, elijamain.

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

Seleccione Crear.

Elija YAMLcerca de la parte superior.

Elimine el código de YAML muestra.

Añada el YAML código 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 CodeCatalyst paquetes en el que creóPaso 2: Cree los repositorios de paquetes CodeCatalyst y Gateway.

Para obtener información sobre las propiedades de este archivo, consulte laCrear y probar acciones YAML.

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

Elija Commit (Confirmar).

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

1. Para el nombre del archivo de flujo de trabajo, mantenga el valor predeterminado,codecatalyst-package-workflow.

2. Para el mensaje de confirmación, introduzca:

   add initial workflow file

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

4. Para el nombre de la sucursal, elija principal.

5. Elija Commit (Confirmar).

Ahora ha creado un flujo de trabajo.

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

Se inicia una ejecución del flujo de trabajo.

En la notificación verde de la parte superior derecha, elige el enlace a la ejecución. El enlace tiene un aspecto similar aView 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, ve aPaso 5: Verificar el flujo de trabajo.

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

Aparece una lista de mensajes de registro.

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

Aparece 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 dehello-world) indica que la lodash dependencia se utilizó correctamente.

Amplíe el npm list registro.

Aparece un mensaje similar al siguiente:

└── lodash@4.17.20

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

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

Elige npm-publish-registry-gateway.

Elija lodash.

Cerca de la parte superior, selecciona los controles de Origin.

En Upstream, selecciona Bloquear.

Seleccione Guardar.

Ahora has bloqueado las importaciones a tu repositorio de gateway (y a los repositorios y ordenadores posteriores) 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).

Agregue, confirme y presione:

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

Ejecute el flujo de trabajo con la versión no coincidente:

Compruebe que se ha producido un error en el flujo de trabajo:

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

npm-publish-registry-gatewayElige.

Elija lodash.

Cerca de la parte superior, selecciona los controles de Origin.

En Upstream, selecciona Permitir.

Seleccione Guardar.

Ahora has desbloqueado las importaciones de. lodash

Su flujo de trabajo ahora puede importar la versión 4.17.21 de. lodash

Vuelva a ejecutar el flujo de trabajo. Esta vez, el flujo de trabajo debería funcionar correctamente porque la importación de la versión 4.17.21 debería funcionar ahora. Para volver a ejecutar el flujo de trabajo:

Compruebe que la versión 4.17.21 se haya importado a sus repositorios y a los de Gateway CodeCatalyst :

Eliminecodecatalyst-package-project:

1. En la CodeCatalyst consola, navega hasta el codecatalyst-package-project proyecto si aún no lo has hecho.

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

3. Seleccione Eliminar proyectodelete, introduzca y elija Eliminar proyecto.

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

Elimine el PAT token:

1. Elige tu nombre de usuario a la derecha y, a continuación, selecciona Mi configuración.

2. En Tokens de acceso personal, elige el token que creaste en este tutorial y selecciona Eliminar.