Creación de configuraciones de Satellite desde la consola

Para desplegar una app de ejemplo, consulte Despliegue de recursos de Kubernetes en clústeres con Satellite Config.

Para crear la configuración personalizada, utilice la interfaz de usuario de Satellite y siga estos pasos.

1. Inicie sesión en la IU de configuración deSatellite con sus credenciales de IBM Cloud.

2. Pulse Crear configuración.

3. En la página Examinar plantillas, seleccione la plantilla Carga directa.

4. En la página Configuración, especifique el nombre de configuración y la ubicación de los datos.

5. En la página Versión, especifique el nombre y la descripción de la versión. A continuación, cargue un archivo existente o utilice el editor YAML para pegar en el contenido del archivo.

6. En la página Suscripción, especifique el nombre de suscripción, la versión de suscripción y el grupo de clústeres en los que se va a desplegar.

7. En la página Resumen, confirme que la información visualizada es correcta y, a continuación, pulse Completar.

Creación de configuraciones de Satellite desde la CLI

Utilice el plug-in de CLI para mandatos de Satellite para crear una configuración y cargar la definición de recurso de Kubernetes que desea desplegar en los clústeres.

Para crear la configuración:

1. Configure los clústeres para utilizarlos con la configuración de Satellite. Esta configuración incluye la creación de un grupo de clústeres y el otorgamiento de acceso de configuración de Satellite a los clústeres.

2. Añada clústeres al grupo de clústeres. Los clústeres se pueden ejecutar en su ubicación o en IBM Cloud.

   1. Liste los clústeres que están registrados con el componente de configuración de Satellite y anote su ID.

      ibmcloud sat cluster ls
      

   2. Añada el clúster al grupo de clústeres.

      ibmcloud sat group attach --cluster <cluster_ID> --group <cluster_group_name>
      

   3. Verifique que el clúster se ha añadido correctamente al grupo de clústeres.

      ibmcloud sat group get --group <cluster_group_name>
      

3. Cree una configuración deSatellite.

   ibmcloud sat config create --name <config_name> [--data-location <location>] [-q]
   

   Descripción de los componentes de este mandato

   Componente	Descripción
   --name <config_name>	Especifique el nombre de la configuración de Satellite.
   --data-location <location>	Especifique la ubicación para almacenar las configuraciones de Satellite, por ejemplo us-east. Las configuraciones de Satellite son definiciones de recursos de Kubernetes, como por ejemplo ConfigMaps, clases de almacenamiento o secretos que se despliegan en los clústeres de la ubicación a través de suscripciones. Si no se especifica --data-location, las configuraciones se almacenan en us-east de forma predeterminada. Estas ubicaciones son grupos de IBM Cloud Object Storage que son propiedad de IBM y están presuministrados en cada región. Para obtener más información sobre cómo se almacenan los datos, consulte ¿Cómo se almacena, se hace copia de seguridad y se cifra mi información?. Para obtener una lista de ubicaciones, consulte Ubicaciones admitidas.
   -q	No mostrar el mensaje del día ni los recordatorios de actualización.

   Salida de ejemplo

   Creating configuration...
   OK
   Configuration <config_name> was successfully created with ID 116fffde-0835-467c-8987-67dd42e4e393.
   

4. Cree una Suscripción para el grupo de clústeres en la configuración de Satellite. Después de crear la suscripción, la configuración de Satellite descarga automáticamente el archivo de recursos de Kubernetes para la versión que ha especificado y empieza a aplicar este archivo en todos los clústeres que pertenecen al grupo de clústeres. Este proceso tarda unos cinco minutos en completarse. Además, la información sobre todos los recursos de Kubernetes que cree se devuelven desde los clústeres a Satellite Config y se pueden revisar en el panel de control Satellite Recursos de clúster. Revise las opciones del mandato ejecutando ibmcloud sat subscription create.

   ibmcloud sat subscription create --group <cluster_group_name> --config <config_name_or_ID> --name <subscription_name> --version <version_name_or_ID>
   

   Descripción de los componentes de este mandato

   Componente	Descripción
   --group <cluster_group_name>	Especifique el nombre del grupo de clústeres en el que desea desplegar los recursos de Kubernetes.
   --config <config_name_or_ID>	Especifique el nombre o el ID de la configuración de Satellite que ha creado anteriormente.
   --name <subscription_name>	Especifique un nombre para la suscripción de Satellite.
   --version <version_name_or_ID>	Especifique el nombre o el ID de la definición de recursos de Kubernetes que ha añadido como versión a la configuración. Para listar las versiones disponibles, ejecute ibmcloud sat config get --config <config_name_or_ID>

   Salida de ejemplo

   Creating subscription...
   OK
   Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
   

5. Siga el paso 5 del tema sobre Creación de configuraciones de Satellite desde la consola para revisar el estado de despliegue de los recursos de Kubernetes.

Actualización de la configuración de Satellite desde la consola

Utilice la consola de Satellite para cargar un nuevo archivo de versión y cambiar la suscripción para utilizarlo.

1. En el menú de acciones de una configuración, pulse Añadir versión.
   1. Especifique un nombre y una descripción opcional para la versión.
   2. Cargue un archivo YAML de recurso de Kubernetes o utilice el editor para especificar directamente la definición del recurso de Kubernetes. Asegúrese de especificar el espacio de nombres de Kubernetes donde desea desplegar el recurso. Si no especifica un espacio de nombres, el recurso se despliega en el espacio de nombres razeedeploy de forma predeterminada.
   3. Opcional: Para ver los recursos una vez creados en el clúster a través del panel de control de Satellite Config, añada la etiqueta razee/watch-resource=lite a la sección metadata.labels del archivo YAML o elija otra opción para ver los recursos desplegados como, por ejemplo, añadir un mapa de configuración al clúster.
   4. Pulse Añadir para añadir la definición de recursos de Kubernetes como una versión a la configuración.
2. Cree una Suscripción para el grupo de clústeres. La suscripción define qué configuración de Satellite para desplegar los recursos de Kubernetes en los clústeres.
   1. Seleccione la configuración que ha creado para ver los detalles de la configuración.
   2. Pulse Crear suscripción.
   3. Especifique un nombre para la suscripción y seleccione el nombre de versión y el grupo de clústeres que ha creado anteriormente.
   4. Haga clic en Crear para crear la suscripción.
3. Seleccione la suscripción para ver los detalles de la suscripción y el estado del despliegue de recursos de Kubernetes. Si se producen errores durante el despliegue, como por ejemplo archivos YAML con errores de formato o valores de versión de API no soportados, puede ver el mensaje de error en la columna Mensaje de los detalles de la suscripción.

(PARA ACTUALIZAR CON NUEVOS MANDATOS:) Actualización de la configuración de Satellite con la CLI

Utilice el plugin de CLI para los mandatos Satellite para cargar un nuevo archivo de versión y cambiar la suscripción para utilizarlo.

1. Cree una Versión cargando un archivo de recursos de Kubernetes en la configuración. Asegúrese de especificar el espacio de nombres de Kubernetes donde desea desplegar el recurso. Si no especifica un espacio de nombres, el recurso se despliega en el espacio de nombres razeedeploy de forma predeterminada. Revise las opciones de mandatos ejecutando ibmcloud sat config version create.

   Para ver los recursos una vez creados en el clúster a través del panel control de Satellite Config, añada la etiqueta razee/watch-resource=lite a la sección metadata.labels del archivo YAML o elija otra opción para ver los recursos desplegados como, por ejemplo, añadir un mapa de configuración al clúster.

   ibmcloud sat config version create --name <version_name> --config <config_name_or_ID> --file-format yaml --read-config <file_path>
   

   Descripción de los componentes de este mandato

   Componente	Descripción
   --name <version_name>	Especifique un nombre para la versión de configuración.
   --config <config_name_or_ID>	Especifique el nombre o el ID de la configuración de Satellite que ha creado anteriormente.
   --read-config <file_path>	Especifique la vía de acceso del archivo relativa al archivo de recursos de Kubernetes en la máquina local.

   Salida de ejemplo

   Creating configuration version...
   OK
   Configuration Version <version_name> was successfully created with ID ad5ae7a9-4f74-486c-816a-32de98de00df.
   

2. Cree una Suscripción para el grupo de clústeres en la configuración de Satellite. Después de crear la suscripción, la configuración de Satellite descarga automáticamente el archivo de recursos de Kubernetes para la versión que ha especificado y empieza a aplicar este archivo en todos los clústeres que pertenecen al grupo de clústeres. Este proceso tarda unos cinco minutos en completarse. Además, la información sobre todos los recursos de Kubernetes que cree se devuelven desde los clústeres a Satellite Config y se pueden revisar en el panel de control Satellite Recursos de clúster. Revise las opciones del mandato ejecutando ibmcloud sat subscription create.

   ibmcloud sat subscription create --group <cluster_group_name> --config <config_name_or_ID> --name <subscription_name> --version <version_name_or_ID>
   

   Descripción de los componentes de este mandato

   Componente	Descripción
   --group <cluster_group_name>	Especifique el nombre del grupo de clústeres en el que desea desplegar los recursos de Kubernetes.
   --config <config_name_or_ID>	Especifique el nombre o el ID de la configuración de Satellite que ha creado anteriormente.
   --name <subscription_name>	Especifique un nombre para la suscripción de Satellite.
   --version <version_name_or_ID>	Especifique el nombre o el ID de la definición de recursos de Kubernetes que ha añadido como versión a la configuración. Para listar las versiones disponibles, ejecute ibmcloud sat config get --config <config_name_or_ID>

   Salida de ejemplo

   Creating subscription...
   OK
   Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.
   

3. Siga el paso 5 del tema sobre Creación de configuraciones de Satellite desde la consola para revisar el estado de despliegue de los recursos de Kubernetes.