Configuración de StyleBook

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 Citrix ADC y administrar estos StyleBooks. Debe cargar estos StyleBooks a Citrix ADM. Con esta función, puede importar directamente sus StyleBooks presentes en GitHub a Citrix ADM. No es necesario copiarlos manualmente desde GitHub y luego subirlos a Citrix ADM. O bien, sincronice manualmente los archivos en Citrix ADM y GitHub. Además, puede importar y sincronizar paquetes de configuración desde GitHub.

Para importar StyleBooks y paquetes de configuración, defina un repositorio en Citrix ADM 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.

Después de crear el repositorio, puede sincronizar Citrix ADM con su repositorio de GitHub. Citrix ADM se conecta a GitHub e importa los StyleBooks y los paquetes de configuración que se encuentran en ese repositorio. A continuación, Citrix ADM valida los StyleBooks y los agrega a la lista de StyleBooks de Citrix ADM. Los StyleBooks no se agregan a Citrix ADM 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 Citrix ADM.

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 Citrix ADM.

  • La sincronización de StyleBooks desde un repositorio de GitHub debe iniciarse manualmente desde la GUI o la API de Citrix ADM. 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 Citrix ADM desde cualquier carpeta del repositorio de GitHub. Para importar paquetes de configuración, haga lo siguiente:

  1. Cree una carpeta con el nombre configpacks en el directorio raíz. Asegúrese de que todos los archivos asociados a las configuraciones estén en esta carpeta.

  2. 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 nombre único para identificar un paquete de configuración en Citrix ADM. Si no especifica config_key, Citrix ADM genera automáticamente el ID al crear el paquete de configuración.

      Si el ID especificado se encuentra en la GUI de Citrix ADM, la acción de sincronización actualiza el paquete de configuración en la GUI de Citrix ADM. 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.

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

  1. En Citrix ADM, vaya a Aplicaciones > Configuración > Repositorios. Haga clic en Agregar.

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

    Agregar un repositorio de GitHub

  3. Haga clic en Crear.

    El repositorio se crea en Citrix ADM.

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 Citrix ADM que se importaron anteriormente desde ese repositorio de GitHub.

    Nota

    No puede eliminar un repositorio de Citrix ADM si tiene algún StyleBooks que tenga paquetes de configuración asociados. En primer lugar, elimina todos los paquetes de configuración de estos StyleBooks. Más adelante, puede eliminar el repositorio de Citrix ADM para limpiar los StyleBooks de ese repositorio.

  • Restablecer : puede eliminar todos los StyleBooks de Citrix ADM sincronizados de ese repositorio sin eliminar realmente la entrada del repositorio.

  • Listar archivos : puede ver una lista de todos los StyleBooks presentes en Citrix ADM que se originan en el repositorio de GitHub.

Lista de repositorios de GitHub

Pasos para importar StyleBooks y paquetes de configuración desde GitHub

Después de completar los requisitos previos, siga los pasos para importar StyleBooks y paquetes de configuración desde un repositorio de GitHub:

  1. Opcional, agrega un repositorio si no lo has agregado.
  2. Seleccione el repositorio en la página Repositorios .
  3. Haga clic en Sync
Importar y sincronizar StyleBooks desde el repositorio de GitHub