Saltar al contenido principal

Configuración de su entorno de desarrollo local

En esta sección, en calidad de desarrollador de aseguradora, aprenderá a configurar su entorno de desarrollo local. Esto le permite comenzar a desarrollar su aplicación e impulsar sus cambios.

Note: Debe tener los detalles de inicio de sesión de su inquilino de Guidewire Home antes de configurar su entorno de desarrollo local. Para obtener más información, consulte Acceso a Jutro Web Apps.

Requisitos​

Debe instalar lo siguiente para configurar el entorno de desarrollo:

  • Nodo: >=22.6.0 < 23
  • npm: >=10.8.2
  • Git
  • Un IDE

Siga las instrucciones de instalación según su sistema operativo.

Explicación de los repositorios NPM​

Los paquetes NPM necesarios para las aplicaciones de Jutro se almacenan en instancias separadas del repositorio binario de Guidewire que requieren autenticación.

Hay tres instancias regionales disponibles:

Todos los paquetes de JDP NPM de configuración base están disponibles en el repositorio jutro-npm-dev-local en esas instancias.

Tenga en cuenta que se utilizan diferentes ámbitos de NPM para distribuir diferentes paquetes. Los verá en los prefijos de nombres de paquetes. Los principales ámbitos son estos:

  • @jutro
  • @digitalsdk

Paquetes específicos del cliente​

Al crear aplicaciones de Jutro, además de los paquetes proporcionados por JDP, puede utilizar los creados como paquetes específicos del cliente publicados en un repositorio diferente (jutro-{tenantId}-all-npm-remote).

El repositorio virtual​

Con el fin de facilitar la configuración y el acceso, Guidewire proporciona un repositorio virtual que sirve de proxy de estos dos repositorios, de modo que todos los paquetes de NPM (tanto de JDP como específicos del cliente) estén disponibles a través de él.

El repositorio virtual es jutro-{tenantId}-all-npm-virtual.

Note: La URL completa del repositorio virtual es https://{region}.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual.

Utilice este repositorio cuando configure su entorno local.

Configuración del repositorio requerido en su configuración de NPM​

Como se explicó anteriormente, los paquetes NPM necesarios para las aplicaciones de Jutro se almacenan en tres instancias regionales del repositorio binario de Guidewire:

De forma predeterminada, la aplicación de Jutro que se ejecuta en JDP ya apuntará a la instancia que coincide con el entorno de Guidewire Home en el que se creó.

Durante los pasos de configuración de desarrollo local, se le solicitará que obtenga un token de acceso para la instancia seleccionada.

En estos pasos, se utiliza la instancia de AMER para el ejemplo:

  1. Inicie sesión en https://amer.binrepo.guidewire.net/ con sus credenciales SAML de SSO.

  2. Abra su terminal en su directorio de inicio y siga los pasos a continuación, reemplazando el valor por {tenantId}:

  3. Para configurar el acceso a los artefactos de JDP en el ámbito @jutro, ejecute los siguientes comandos:

npm config set @jutro:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@jutro --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
  1. Para configurar el acceso al ámbito @digitalsdk, ejecute los siguientes comandos:
npm config set @digitalsdk:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@digitalsdk --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
  1. Para configurar el acceso al ámbito de paquetes compartidos específicos del cliente, ejecute los siguientes comandos, reemplazando no solo el {tenantID}, sino también el {startSystemId}:
npm config set @{tenantId}-{starSystemId}:registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual
npm login --scope=@{tenantId}-{starSystemId} --registry=https://amer.binrepo.guidewire.net/artifactory/api/npm/jutro-{tenantId}-all-npm-virtual

Consumo de paquetes compartidos​

Para obtener más información sobre el consumo de paquetes compartidos, consulte Consumo de paquetes compartidos.

Cómo obtener el código fuente de la aplicación​

Para clonar el repositorio de aplicaciones y obtener el código, debe crear un token de acceso HTTP y usarlo como contraseña cuando se le solicite.

  1. Inicie sesión en Guidewire Home y, a continuación, vaya a su aplicación en Jutro Web Apps.

  2. Haga clic en el enlace de código fuente para acceder al repositorio de Bitbucket.

  3. En Bitbucket, haga clic en su avatar y, a continuación, en Administrar cuenta.

  4. En el menú de la izquierda, seleccione Tokens de acceso HTTP y haga clic en Crear un token.

  5. Ingrese un nombre para el token y establezca los permisos en Administrador.

  6. Haga clic en Crear.

  7. Copie y guarde el token de la página siguiente, ya que lo usará como contraseña.

  8. Haga clic en Continuar.

  9. Con el comando de la CLI git clone en una instancia de terminal, clone el repositorio y proporcione el token que creó anteriormente cuando se le solicitó una contraseña.

  10. Una vez que el repositorio se haya clonado correctamente, vaya al nuevo directorio de aplicaciones que creó y ejecute los siguientes comandos en su IDE:

    npm ci
    npm start

    La aplicación ahora se está ejecutando en el navegador.

Solución de problemas​

Si sigue los pasos de la sección Configuración del repositorio requerido en su configuración de NPM , NPM insertará la autenticación y las configuraciones en un archivo .npmrc en su directorio de inicio. Este archivo contendrá la información necesaria para autenticar y acceder a los repositorios requeridos.

Si encuentra problemas de control de acceso al intentar instalar paquetes, compruebe lo siguiente:

  1. Que el usuario tenga acceso a la interfaz de usuario BinRepo de Guidewire y que pueda acceder a las URL del repositorio directamente en un navegador.
  2. Que el archivo .npmrc contenga credenciales válidas para los repositorios y la región a los que intenta acceder.
  3. Que esté ejecutando el comando de instalación en el directorio correcto, donde NPM pueda cargar y encontrar el archivo correcto .npmrc en el árbol de directorios: https://docs.npmjs.com/cli/v8/configuring-npm/npmrc#files.
  4. Que el archivo package-lock.json no contenga referencias de paquetes de otros repositorios en otras regiones con las que no se haya autenticado (por ejemplo, https://apac.binrepo.guidewire.net, en lugar de https://amer.binrepo.guidewire.net).
  5. Que ha intentado purgar node_modules y package-lock.json los ha instalado nuevamente con una configuración de archivo .npmrc correcta después de seguir los pasos anteriores.

Si ninguno de los pasos anteriores resuelve el problema, deberá iniciar un ticket para obtener más ayuda.