Importar y sincronizar StyleBooks desde un repositorio externo
Considera un escenario en el que utilizas procesos de CI/CD para tu desarrollo. O un escenario en el que gestionas todo el código fuente de la aplicación y los artefactos de implementación en GitHub/GitLab.
En el repositorio de GitHub/GitLab, es posible que mantengas varios StyleBooks para implementar las configuraciones de NetScaler y gestionar estos StyleBooks. Debes cargar estos StyleBooks en NetScaler Console. Con esta función, puedes importar directamente tus StyleBooks presentes en GitHub/GitLab a NetScaler Console. No necesitas copiarlos manualmente de GitHub/GitLab y luego cargarlos en NetScaler Console. O sincronizar manualmente los archivos tanto en NetScaler Console como en GitHub/GitLab. Además, puedes importar y sincronizar paquetes de configuración desde GitHub/GitLab.
Para importar StyleBooks y paquetes de configuración, define un repositorio en NetScaler Console que represente un repositorio de GitHub/GitLab. Proporciona la URL del repositorio de GitHub/GitLab y tu nombre de usuario y token de API o de acceso personal (PA) creado en GitHub/GitLab. Esto significa que solo los usuarios autorizados que tengan una cuenta válida en GitHub/GitLab pueden importar y sincronizar StyleBooks.
Puedes importar y sincronizar los siguientes tipos de repositorios:
- Repositorios de acceso público - Los repositorios que están abiertos al público y a los que se puede acceder a través de Internet.
- Repositorios de GitLab/GitHub locales o privados - Los repositorios que se alojan de forma privada y suelen ser accesibles solo dentro de la intranet de una empresa. Para estos repositorios, debes seleccionar un agente de NetScaler durante el proceso de registro. El agente de NetScaler actúa como un proxy para acceder a los repositorios dentro de la intranet de la empresa.
Después de crear el repositorio, puedes sincronizar NetScaler Console con tu repositorio de GitHub/GitLab. NetScaler Console se conecta a GitHub/GitLab e importa los StyleBooks y paquetes de configuración encontrados en ese repositorio. NetScaler Console valida los StyleBooks y los agrega a la lista de StyleBooks en NetScaler Console. Los StyleBooks no se agregan a NetScaler Console si fallan la validación. Puedes identificar y corregir los errores en tus StyleBooks. Luego, confirma las versiones actualizadas en tu repositorio de GitHub/GitLab. Más tarde, puedes intentar importarlos o sincronizarlos de nuevo en NetScaler Console.
Si encuentras el siguiente error al crear un repositorio, indica que NetScaler Console no puede verificar el certificado SSL del repositorio debido a un certificado de Autoridad de Certificación (CA) faltante o no reconocido:
certificate verify failed: unable to get local issuer certificate
Para resolver este problema, puedes agregar manualmente el certificado CA requerido al agente de NetScaler Console que se utiliza para acceder al repositorio. Agregar el certificado CA requerido garantiza que las conexiones seguras al repositorio externo se validen correctamente.
Inicia sesión en el agente de NetScaler Console que se utiliza para acceder al repositorio y agrega tu certificado CA al paquete de certificados de confianza /var/mps/ca_certs/cacert.pem.
Importante
Los archivos StyleBooks se pueden importar y sincronizar desde cualquier rama de un repositorio de GitHub/GitLab.
También puedes importar y sincronizar StyleBooks que tengan StyleBooks dependientes asociados. Estos StyleBooks dependientes pueden estar en el repositorio de GitHub/GitLab o ya presentes en NetScaler Console.
La sincronización de StyleBooks desde un repositorio de GitHub/GitLab debe iniciarse manualmente desde la GUI o la API de NetScaler Console. Es decir, actualmente, la importación y sincronización de StyleBooks no se realiza automáticamente en función de tu actividad de confirmación de GitHub/GitLab.
El archivo del paquete de configuración que deseas importar debe estar en formato JSON. Además, el contenido del archivo de configuración debe seguir el formato de configuración exportado. En tu repositorio de GitHub/GitLab, los archivos asociados con el paquete de configuración deben estar en la carpeta
configpacks.
Puedes importar archivos StyleBook a NetScaler Console desde cualquier carpeta del repositorio de GitHub/GitLab. Para importar paquetes de configuración, haz lo siguiente:
-
Crea una carpeta con el nombre
configpacksen el directorio raíz. Asegúrate de que todos los archivos asociados con las configuraciones estén en esta carpeta. -
En la carpeta
configpacks, crea un archivo JSON que contenga la carga útil para el paquete de configuración. Esta carga útil se utiliza para sincronizar paquetes de configuración. El siguiente es un ejemplo de carga útil:{ "config_key": "unique-key-for-configpack", "parameters": { "param-name1": "param-value1", "param-name": "param-value2", "param-namen": "param-valuen" }, "stylebook": { "namespace": "some namespace", "name": "somename", "version": "spme-version" } } <!--NeedCopy-->-
config_key- Un ID o nombre único para identificar un paquete de configuración en NetScaler Console. Si no especificasconfig_key, NetScaler Console genera automáticamente el ID al crear el paquete de configuración.Si el ID especificado se encuentra en la GUI de NetScaler Console, la acción de sincronización actualiza el paquete de configuración en la GUI de NetScaler Console. De lo contrario, crea un paquete de configuración con el ID especificado.
-
parameters- Contiene todos los parámetros necesarios para crear o actualizar el paquete de configuración. -
stylebook- Es una propiedad obligatoria en un archivo JSON. Contiene un espacio de nombres, una versión y el nombre de StyleBook con el que deseas asociar el paquete de configuración.
-
-
En la carpeta
configpacks, guarda todos los archivos asociados con el paquete de configuración, como certificados, archivos de firma y archivos XML.
Agregar un repositorio
-
En NetScaler Console, ve a Aplicaciones > Configuración > Repositorios. Haz clic en Agregar.
-
En la ventana Agregar repositorio, introduce los siguientes parámetros:
-
Nombre - Escribe el nombre del repositorio. Este nombre puede ser el mismo que el nombre del repositorio en GitHub/GitLab o uno diferente.
-
URL del repositorio - Escribe la URL del repositorio de GitHub/GitLab.
Puedes especificar una URL de empresa de GitHub/GitLab. Te ayuda a importar o sincronizar StyleBooks y paquetes de configuración desde cuentas de empresa de GitHub/GitLab.
-
¿Es una URL privada? - Si el repositorio es un repositorio de GitLab/GitHub local o privado, selecciona esta casilla de verificación y luego selecciona un Agente.
-
Nombre de usuario - Escribe el nombre de usuario que utilizas para acceder a la cuenta de GitHub/GitLab o a la cuenta de empresa.
-
Token de API/PA - Este token se utiliza para acceder a tu repositorio de GitHub/GitLab. Para obtener información sobre cómo crear tokens de API/PA para tu repositorio de GitHub/GitLab, consulta la documentación de GitHub/GitLab sobre cómo crear tokens de acceso personal.
-
-
Haz clic en Crear.
El repositorio se crea en NetScaler Console.
Opciones del repositorio
Las siguientes son las opciones adicionales para tus repositorios:
-
Editar - Puedes modificar la URL del repositorio, el nombre de usuario y el token de API.
-
Eliminar - Puedes eliminar el repositorio junto con todos los StyleBooks presentes en NetScaler Console que se importaron previamente desde ese repositorio de GitHub/GitLab.
Nota
No puedes eliminar un repositorio de NetScaler Console si tiene StyleBooks que tienen paquetes de configuración asociados. Primero, elimina todos los paquetes de configuración de estos StyleBooks. Más tarde, puedes quitar el repositorio de NetScaler Console para limpiar los StyleBooks de ese repositorio.
-
Restablecer - Puedes quitar todos los StyleBooks en NetScaler Console sincronizados desde ese repositorio sin eliminar realmente la entrada del repositorio.
-
Listar archivos - Puedes ver una lista de todos los StyleBooks presentes en NetScaler Console que provienen del repositorio de GitHub/GitLab.
Pasos para importar StyleBooks y paquetes de configuración desde GitHub/GitLab
Después de completar los requisitos previos, sigue los pasos para importar StyleBooks y paquetes de configuración desde un repositorio de GitHub/GitLab:
- Opcional, agrega un repositorio si no lo has hecho.
- Selecciona el repositorio en la página Repositorios.
- Haz clic en Sincronizar.