Los namespaces se utilizan para dividir los recursos de un clúster de Kubernetes en espacios virtuales y aislados. Este tema describe cómo crear un namespace, habilitar la inyección automática de proxy sidecar para un namespace, sincronizar las etiquetas de inyección automática de proxy sidecar entre una instancia de Service Mesh (ASM) y un clúster de Kubernetes, y modificar los clústeres a los que pertenece un namespace global.
Creación de un namespace
Los namespaces que se crean en una instancia de Service Mesh (ASM), ya sea desde la consola de ASM o con el cliente kubectl, pertenecen únicamente a dicha instancia. Son independientes de los clústeres de Kubernetes del plano de datos que gestiona la instancia de ASM. Por lo tanto, los namespaces de la instancia de ASM pueden diferir de los de los clústeres de Kubernetes del plano de datos gestionados por esta. Cuando se crean o eliminan namespaces en la instancia de Service Mesh, los namespaces de los clústeres de Kubernetes del plano de datos no se ven afectados.
Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, seleccione .
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, seleccione .
-
En la página Global Namespace, haga clic en Create. En el panel Create Namespace, configure los parámetros y haga clic en OK.
Parámetro
Descripción
Name
Especifique un nombre para el namespace. El nombre debe tener entre 1 y 63 caracteres, y solo puede contener dígitos, letras y guiones (-). Debe comenzar y terminar con una letra o un dígito.
Labels
Haga clic en Add a la derecha de Labels. Introduzca una clave y un valor para agregar una etiqueta al namespace.
Se pueden agregar varias etiquetas a un namespace. Las etiquetas sirven para identificar namespaces. Por ejemplo, puede etiquetar un namespace como parte del entorno de pruebas.
Una vez creado el namespace, puede realizar las siguientes operaciones en la columna Actions de la página Global Namespace:
Para editar un namespace, haga clic en View YAML. En el cuadro de diálogo Edit, modifique la configuración YAML y haga clic en OK.
Para eliminar un namespace, haga clic en Delete. En el cuadro de diálogo Confirm, haga clic en OK.
Habilitación de la inyección automática de proxy sidecar
Cuando se habilita la inyección automática de proxy sidecar para un namespace, se inyecta automáticamente un proxy Envoy como sidecar en cada pod que se crea dentro de ese namespace. Estos proxies Envoy conforman el plano de datos de la instancia de ASM.
Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, seleccione .
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, seleccione .
-
En la página Global Namespace, busque el namespace deseado y haga clic en Enable Sidecar Auto-injection en la columna Automatic Sidecar Injection. En el cuadro de diálogo Confirm, haga clic en OK.
NotaDespués de habilitar la inyección automática de proxy sidecar para un pod, debe reiniciar el pod para que la configuración surta efecto. Para obtener más información, consulte la sección "(Optional) Redeploy workloads" en Configure sidecar proxies.
Sincronización de etiquetas de inyección automática de proxy sidecar entre una instancia de ASM y un clúster de Kubernetes del plano de datos
Los namespaces que se crean en una instancia de ASM, ya sea desde la consola de ASM o con el cliente kubectl, pertenecen únicamente a dicha instancia. Son independientes de los clústeres de Kubernetes del plano de datos que gestiona la instancia de ASM. Puede sincronizar los namespaces y sus etiquetas de inyección automática de proxy sidecar desde una instancia de ASM hacia los clústeres de Kubernetes del plano de datos a los que pertenecen, y viceversa.
Sincronización de etiquetas de inyección automática de proxy sidecar desde un clúster de Kubernetes del plano de datos hacia una instancia de ASM
Al sincronizar las etiquetas de inyección automática de proxy sidecar desde un clúster de Kubernetes del plano de datos hacia una instancia de ASM, ocurre lo siguiente:
Si un namespace existe en el clúster de Kubernetes del plano de datos pero no en la instancia de ASM, se crea automáticamente.
Si un namespace del clúster de Kubernetes del plano de datos tiene la etiqueta
istio-injectiono la etiquetaistio.io/rev, esta se sincroniza automáticamente con el namespace del mismo nombre en la instancia de ASM.
Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, seleccione .
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, seleccione .
-
En la página Global Namespace, haga clic en Sync Auto-injection from Kubernetes Cluster. En el cuadro de diálogo Sync Auto-injection from Kubernetes Cluster, seleccione el clúster de origen del plano de datos y haga clic en OK.
En la página Global Namespace, comprobará que los namespaces globales de la instancia de ASM ahora están sincronizados con el clúster del plano de datos.
Sincronización de etiquetas de inyección automática de proxy sidecar desde una instancia de ASM hacia los clústeres de Kubernetes del plano de datos
Cuando se modifica un namespace de una instancia de ASM, las etiquetas de inyección automática de proxy sidecar de dicho namespace se sincronizan automáticamente con los clústeres de Kubernetes del plano de datos a los que pertenece. Solo es necesario ejecutar esta operación si los namespaces de la instancia de ASM difieren de los de los clústeres del plano de datos debido a modificaciones previas en estos últimos.
Al sincronizar las etiquetas de inyección automática de proxy sidecar desde una instancia de ASM hacia los clústeres de Kubernetes del plano de datos, ocurre lo siguiente:
Si un namespace existe en la instancia de ASM pero no en los clústeres de Kubernetes del plano de datos, se crea automáticamente.
Si un namespace de la instancia de ASM tiene la etiqueta
istio-injectiono la etiquetaistio.io/rev, esta se sincroniza automáticamente con el namespace del mismo nombre en el clúster de Kubernetes del plano de datos.Las etiquetas de los namespaces de la instancia de ASM se sincronizan con todos los clústeres de Kubernetes del plano de datos.
Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, seleccione .
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, seleccione .
-
En la página Global Namespace, haga clic en Sync Auto-injection to Kubernetes Cluster.
Comprobará que los namespaces del clúster de Kubernetes del plano de datos están sincronizados con la instancia de ASM. Para obtener más información sobre cómo consultar los namespaces de un clúster de Kubernetes del plano de datos, consulte Manage namespaces and resource quotas.
Modificación de los clústeres a los que pertenece un namespace global
Si se agregaron varios clústeres de Kubernetes del plano de datos a la instancia de ASM, es posible modificar los clústeres a los que pertenece un namespace global. Cuando synchronize automatic sidecar proxy injection labels from an ASM instance to the Kubernetes clusters on the data plane, los namespaces de la instancia de ASM y sus etiquetas de inyección automática de proxy sidecar se sincronizan con distintos clústeres de Kubernetes del plano de datos, según los clústeres a los que pertenezcan dichos namespaces.
Para usar esta función, la versión de su instancia de ASM debe ser la 1.17.2.37 o posterior. Para obtener más información sobre cómo actualizar una instancia de ASM, consulte Upgrade an ASM instance. Los clústeres a los que pertenece un namespace global se pueden modificar mediante uno de los métodos a continuación:
Método 1: El sistema modifica automáticamente los clústeres al sincronizar las etiquetas de inyección automática de proxy sidecar desde un clúster de Kubernetes del plano de datos hacia una instancia de ASM
Cuando synchronize automatic sidecar proxy injection labels from a Kubernetes cluster on the data plane to an ASM instance, también se sincroniza la relación de pertenencia entre el clúster y los namespaces globales.
Método 2: Modificación manual de los clústeres a los que pertenece un namespace global
Cuando synchronize automatic sidecar proxy injection labels from an ASM instance to the Kubernetes clusters on the data plane, ocurre lo siguiente con los clústeres a los que pertenecen los namespaces globales:
Al sincronizar un namespace global, si un clúster de Kubernetes no forma parte de los clústeres a los que pertenece dicho namespace, ni el namespace ni sus etiquetas de inyección automática de proxy sidecar se sincronizan con el plano de datos.
Agregue varios clústeres a una instancia de ASM. Para obtener más información, consulte Add a cluster to an ASM instance o Use a serverless gateway managed by ASM to implement a multi-cluster ingress.
Inicie sesión en la consola de ASM. En el panel de navegación izquierdo, seleccione .
En la página Mesh Management, haga clic en el nombre de la instancia de ASM. En el panel de navegación izquierdo, seleccione .
En la página Global Namespace, busque el namespace deseado y haga clic en Edit en la columna Homing Cluster. En el cuadro de diálogo que aparece, seleccione uno o más clústeres del plano de datos y haga clic en OK.