Importar y sincronizar StyleBooks desde el repositorio de GitHub
Considere un caso en el que esté utilizando procesos de CI/CD para su desarrollo. O bien, un escenario en el que administres todo el código fuente de la aplicación y los artefactos de implementación en GitHub.
En el repositorio de GitHub, es posible que mantenga varios StyleBooks para implementar las configuraciones de NetScaler y administrar estos StyleBooks. Debe cargar estos StyleBooks en NetScaler Console. Con esta función, puede importar directamente sus StyleBooks presentes en GitHub a NetScaler Console. No es necesario copiarlos manualmente de GitHub y, a continuación, subirlos a NetScaler Console. O bien, sincronice manualmente los archivos en NetScaler Console y GitHub. Además, puedes importar y sincronizar paquetes de configuración desde GitHub.
Para importar StyleBooks y paquetes de configuración, defina un repositorio en NetScaler Console que represente un repositorio de GitHub. Proporciona la URL del repositorio de GitHub y tu nombre de usuario y el token de API creados en GitHub. Esto significa que solo los usuarios autorizados que tengan una cuenta válida en GitHub pueden importar y sincronizar StyleBooks.
Tras crear el repositorio, puede sincronizar NetScaler Console con su repositorio de GitHub. NetScaler Console se conecta a GitHub e importa los StyleBooks y los paquetes de configuración que se encuentran en ese repositorio. A continuación, NetScaler Console valida los StyleBooks y los añade a la lista de StyleBooks de NetScaler Console. Los StyleBooks no se agregan a NetScaler Console si no se validan. Puede identificar y corregir los errores de sus StyleBooks. Luego, confirma las versiones actualizadas en tu repositorio de GitHub. Más adelante, puede intentar importarlos o sincronizarlos de nuevo en NetScaler Console.
Importante
Los archivos de StyleBooks se pueden importar y sincronizar desde cualquier rama de un repositorio de GitHub.
También puede importar y sincronizar los StyleBooks que tengan libros de estilo dependientes asociados a ellos. Estos StyleBooks dependientes pueden estar en el repositorio de Github o ya estar presentes en NetScaler Console.
La sincronización de StyleBooks desde un repositorio de GitHub debe iniciarse manualmente desde la GUI o 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.
El archivo del paquete de configuración que quiere 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, los archivos asociados al paquete de configuración deben estar en la carpeta
configpacks.
Puede importar archivos de StyleBook a NetScaler Console desde cualquier carpeta del repositorio de GitHub. Para importar paquetes de configuración, haga lo siguiente:
-
Cree una carpeta con el nombre
configpacksen el directorio raíz. Asegúrese de que todos los archivos asociados a las configuraciones estén en esta carpeta. -
En la carpeta
configpacks, cree un archivo JSON que contenga la carga útil del paquete de configuración. Esta carga útil se usa para sincronizar los 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 identificador o un nombre únicos para identificar un paquete de configuración en NetScaler Console. Si no especifica config_key, NetScaler Console generará 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 un nombre de StyleBook a los que quiere asociar el paquete de configuración.
-
-
En la carpeta
configpacks, guarde todos los archivos que están asociados al paquete de configuración, como los certificados, los archivos de firmas y los archivos XML.
Agregar un repositorio
-
En NetScaler Console, vaya a Aplicaciones > Configuración Repositorios. Haga clic en Agregar.
-
En la ventana Agregar Repositorio, introduzca los siguientes parámetros:
-
Nombre : escriba el nombre del repositorio. Este nombre puede ser el mismo que el nombre del repositorio en GitHub o uno diferente.
-
URL del repositorio : escriba la URL del repositorio de GitHub.
Puedes especificar una URL empresarial de GitHub. Te ayuda a importar o sincronizar StyleBooks y paquetes de configuración desde cuentas empresariales de GitHub.
-
Nombre de usuario : escribe el nombre de usuario que usas para acceder a la cuenta de GitHub o a la cuenta empresarial.
-
API Token - Este token se usa para acceder a su repositorio de GitHub. Para obtener información sobre cómo crear tokens de API para su repositorio de GitHub, consulta la documentación de GitHub para crear tokens de acceso personales.
-
-
Haga clic en Crear.
El repositorio se crea en NetScaler Console.
Opciones de repositorio
Las siguientes son las opciones adicionales para tus repositorios:
-
Modificar : puede modificar la URL del repositorio, el nombre de usuario y el token de API.
-
Eliminar: puede eliminar el repositorio junto con todos los StyleBooks presentes en NetScaler Console que se importaron anteriormente desde ese repositorio de GitHub.
Nota
No puede eliminar un repositorio de NetScaler Console si tiene algún StyleBooks que tenga paquetes de configuración asociados. Primero, borra todos los paquetes de configuración de estos StyleBooks. Más adelante, puede eliminar el repositorio de NetScaler Console para limpiar los StyleBooks de ese repositorio.
-
Restablecer: puede eliminar todos los StyleBooks de NetScaler Console sincronizados desde ese repositorio sin eliminar realmente la entrada del repositorio.
-
Lista de archivos: puede ver una lista de todos los StyleBooks presentes en NetScaler Console que se originan en el repositorio de GitHub.
Pasos para importar StyleBooks y paquetes de configuración desde GitHub
Después de completar los requisitos previos, sigue los pasos para importar StyleBooks y paquetes de configuración desde un repositorio de GitHub:
- Opcional, agrega un repositorio si no lo has agregado.
- Seleccione el repositorio en la página Repositorios.
- Haga clic en Sync