Configuración de un dominio para el clúster
Al crear un clúster, se registra por defecto un subdominio Ingress para su clúster con el formato <cluster_name>.<globally_unique_account_HASH>-0000.<region>.containers.appdomain.cloud
. Además, puede hacer que sus
apps sean accesibles en un dominio personalizado creando su propio dominio registrado con el proveedor de dominio interno de IBM Cloud, o un dominio registrado con un proveedor externo. También puede añadir un dominio existente al clúster.
Esta funcionalidad está disponible en versión beta y está sujeta a cambios.
IBM Cloud proporciona un proveedor interno gestionado que puede utilizar para crear sus propios dominios. Con el proveedor de dominio gestionado, no es necesario crear y mantener una cuenta con un proveedor externo. También puede utilizar la monitorización
del estado de sus dominios gestionados. Al crear un dominio con el proveedor interno, se especifica un nombre de subdominio, como por ejemplo exampledomain
, y el nuevo dominio se denomina con el formato exampledomain.<zone>.containers.appdomain.cloud
.
También puede utilizar su propia instancia IBM Cloud Internet Services como proveedor externo para sus dominios de clúster.
También puede utilizar la anotación service.kubernetes.io/ibm-load-balancer-cloud-provider-dns-name
VPC load balancer para crear un nuevo dominio o registrar un dominio existente en su VPC load balancer. Para obtener más información,
consulte la descripción de la anotación en la documentación de VPC ALB o VPC NLB.
Acceso a dominios en la consola
Vaya a la página Dominios del clúster para crear y gestionar dominios.
- En la consola, vaya al separador de clústeres.
- Haga clic en el grupo donde desea crear o cambiar un dominio.
- Pulse Ingress.
- Pulse el separador Dominios. Desde aquí, puede gestionar los dominios asociados con el clúster.
Creación de dominios en la consola
Utilice la consola de IBM Cloud para crear su propio dominio en el clúster, o añada un dominio que ya exista en la cuenta de proveedor. Siga las instrucciones de la consola para realizar las siguientes configuraciones de dominio.
Si utiliza el proveedor IBM Cloud Internet Services, primero debe configurar la autorización de servicio a servicio para la instancia de IBM
Cloud Internet Services. Establezca el servicio de origen como Kubernetes Service
y el destino como Internet services
. Asigne el rol Manager
.
Detalles de dominio
- Nombre de dominio: el nombre del dominio que se va a crear o añadir al clúster. Puede ser un dominio que exista en su cuenta de proveedor o un dominio nuevo.
- Proveedor: elija un proveedor para su dominio. Para crear un dominio gestionado con el proveedor interno de IBM Cloud, elija Gestionado. Para utilizar un proveedor externo, elija entre los tipos de proveedor restantes.
- Establecer como valor predeterminado: elija si desea establecer el dominio como valor predeterminado para el clúster. El dominio Ingress predeterminado se utiliza para formar una URL única para cada una de sus aplicaciones y es el dominio al que hacen referencia las direcciones IP de cualquier ALB público de su clúster. Puede cambiar qué dominio se establece como predeterminado en cualquier momento. El establecimiento de un dominio predeterminado sustituye al valor predeterminado actual.
Detalles de registro
- Añada una o más direcciones IP (para clústeres clásicos o de VPC) o Nombres de host (para clústeres de VPC) para registrarse en el dominio. Puede actualizar qué direcciones IP o nombres de host están registrados.
- Espacio de nombres de secreto: especifique el espacio de nombres en el que se crea el secreto TLS para el dominio. Si no especifica un espacio de nombres, el secreto se crea en el espacio de nombres
default
.
Gestionar su dominio en la consola
Puede realizar las acciones siguientes para gestionar el dominio.
- Suprimir un dominio
- Si suprime un dominio de un clúster, el dominio no se puede recuperar. Si posteriormente necesita el dominio, debe volver a suministrarlo. Si suprime un dominio que está registrado con el proveedor gestionado, no puede reutilizar ese nombre de dominio. Tenga en cuenta que no puede suprimir el dominio predeterminado de un clúster. Si desea suprimir el dominio que está registrado actualmente como predeterminado, primero debe asignar un dominio predeterminado diferente.
- Actualizar las direcciones IP o el nombre de host de un dominio
- Al actualizar las direcciones IP o nombres de host, debe incluir las IP o nombres de host que estén registrados actualmente en el dominio. El dominio se actualiza con los valores exactos especificados, por lo que las direcciones IP o nombres
de host actuales se sobrescriben si no se incluyen. Por ejemplo, si
52.137.182.166
está registrado actualmente en el dominio y desea añadir52.137.182.270
, debe especificar ambas direcciones IP. - Cambiar el dominio por defecto de un cluster
- Puede cambiar el dominio predeterminado a cualquier dominio que exista en el clúster. Este cambio puede tardar hasta cinco minutos en aplicarse. Durante ese tiempo, es posible que el dominio experimente un tiempo de inactividad.
Configuración de dominios con el proveedor interno IBM Cloud gestionado
IBM Cloud proporciona un proveedor interno gestionado que puede utilizar para crear sus propios dominios. Puede utilizar el mandato ibmcloud ks ingress domain create
para crear un dominio nuevo o puede especificar un dominio existente
que desee añadir al clúster. Al crear un dominio con el proveedor interno, puede especificar un nombre de subdominio, como por ejemplo exampledomain
, o proporcionar el nombre de dominio completo. El nuevo dominio se denomina con
el formato exampledomain.<zone>.containers.appdomain.cloud
.
El proveedor de dominio gestionado interno IBM Cloud es Akamai. También puede utilizar su propia cuenta de Akamai para crear o añadir dominios. Cuando obtenga los detalles de un dominio, es posible que vea el tipo de proveedor listado como akamai
o akamai-ext
. El tipo de proveedor akamai
hace referencia al proveedor de dominio interno IBM Cloud y akamai-ext
hace referencia a su propia cuenta externa de Akamai con la que registra directamente el
dominio. Si proporciona el nombre de dominio completo, la zona del dominio debe coincidir con la zona en la que se ha creado el clúster.
ibmcloud ks ingress domain create --cluster CLUSTER [--is-default] [--domain DOMAIN] [--hostname HOSTNAME] [--ip IP] [--output OUTPUT] [-q] [--secret-namespace NAMESPACE]
-c, --cluster CLUSTER
- Obligatorio. El nombre o ID del cluster donde quieres crear el dominio.
--is-default
- Opcional. Incluya esta opción para establecer el dominio correspondiente como dominio predeterminado del clúster.
--domain DOMAIN
- El dominio para crear o añadir al clúster. Puede ser un dominio que exista en su cuenta de proveedor o un dominio nuevo.
--hostname HOSTNAME
- Opcional. Para clústeres de VPC. El nombre de host a registrar para el dominio.
--ip IP
- Opcional. Las direcciones IP para registrarse en el dominio.
--output OUTPUT
- Opcional: muestra la salida del mandato en formato JSON.
--secret-namespace NAMESPACE
- Opcional. El espacio de nombres en el que se crea el secreto TLS del dominio. Si no se especifica ningún espacio de nombres, el secreto se crea en el espacio de nombres
default
.
Configuración de dominios con IBM Cloud Internet Services
Siga los pasos para crear un dominio con IBM Cloud Internet Services.
Configurar autorización de servicio a servicio
La creación de un dominio con IBM Cloud Internet Services requiere que configure la autorización de servicio a servicio para la instancia de IBM Cloud Internet
Services. Establezca el servicio de origen como Kubernetes Service
y el destino como Internet services
. Asigne el rol Manager
.
Crear un dominio
Cree un dominio nuevo o especifique un dominio existente que desee añadir al clúster. Para especificar un dominio existente, incluya el nombre de dominio completo con la zona de proveedor externo, como por ejemplo exampledomain.externalzone.com
.
Para crear un nuevo dominio, debe seguir incluyendo la zona de proveedor externo, pero puede personalizar la parte del subdominio, como por ejemplo custom.exampledomain.externalzone.com
. Tenga en cuenta que el nombre de dominio
debe ser exclusivo en la zona en la que está registrado.
Si suprime un dominio que está registrado con el proveedor interno de IBM, no puede reutilizar el nombre de dominio.
ibmcloud ks ingress domain create --cluster CLUSTER [--crn CRN] [--is-default] [--domain DOMAIN] [--hostname HOSTNAME] [--ip IP] [--output OUTPUT] [--domain-provider PROVIDER] [-q] [--secret-namespace NAMESPACE] [--zone ZONE]
-c, --cluster CLUSTER
- Obligatorio. El nombre o ID del cluster donde quieres crear el dominio.
--crn CRN
- Necesario para los dominios de IBM Cloud Internet Services. El CRN de la instancia de IBM Cloud Internet Services.
--is-default
- Opcional. Incluya esta opción para establecer el dominio correspondiente como dominio predeterminado del clúster.
--domain DOMAIN
- El dominio para crear o añadir al clúster. Puede ser un dominio que exista en su cuenta de proveedor o un dominio nuevo.
--hostname HOSTNAME
- Para clústeres de VPC. El nombre de host a registrar para el dominio.
--ip IP
- Las direcciones IP para registrarse en el dominio.
--output OUTPUT
- Opcional: muestra la salida del mandato en formato JSON.
--domain-provider PROVIDER
- Obligatorio. El tipo de proveedor de DNS externo. Especifique
--cis-ext
. --secret-namespace NAMESPACE
- Opcional. El espacio de nombres en el que se crea el secreto TLS del dominio. Si no se especifica ningún espacio de nombres, el secreto se crea en el espacio de nombres
default
. --domain-zone ZONE
- Opcional. El ID de dominio para la instancia de IBM Cloud Internet Services. Se trata de un valor GUID.
Gestión de dominios
Aprenda a gestionar los dominios que existen en el clúster.
Listado de todos los dominios de un clúster
Para obtener más detalles y opciones de mandato, consulte la Referencia de CLI.
ibmcloud ks ingress domain ls --cluster CLUSTER
Obtención de los detalles de un único dominio
Para obtener más detalles y opciones de mandato, consulte la Referencia de CLI.
ibmcloud ks ingress domain get --cluster CLUSTER --domain DOMAIN
Eliminación de un dominio de un clúster
Si suprime un dominio de un clúster, el dominio no se puede recuperar. Si posteriormente necesita el dominio, debe volver a suministrarlo. Tenga en cuenta que no puede suprimir el dominio predeterminado de un clúster. Si desea suprimir el dominio que está registrado actualmente como predeterminado, primero debe asignar un dominio predeterminado diferente.
Si suprime un dominio que está registrado con el proveedor interno de IBM, no puede reutilizar el nombre de dominio.
Para obtener más detalles y opciones de mandato, consulte la Referencia de CLI.
ibmcloud ks ingress domain rm --cluster CLUSTER --domain DOMAIN
Actualización de direcciones IP o nombre de host de un dominio
Puede actualizar las direcciones IP registradas de un dominio (para clústeres clásicos o de VPC) o el nombre de host (para clústeres de VPC) después de crear o añadir el dominio al clúster. Este mandato actualiza todos los recursos del clúster con las direcciones IP o nombres de host especificados y cambia los URL de la app.
Para obtener más información y opciones de mandato, consulte la Referencia de CLI.
Tenga en cuenta que cuando añada direcciones IP o nombres de host, debe incluir las IP o nombres de host que estén registrados actualmente en el dominio. El dominio se actualiza con los valores exactos especificados, por lo que las direcciones
IP o nombres de host actuales se sobrescriben si no se incluyen. Por ejemplo, si 52.137.182.166
está registrado actualmente en el dominio y desea añadir 52.137.182.270
, debe especificar --ip 52.137.182.166 --ip 52.137.182.270
en el mandato.
ibmcloud ks ingress domain update --cluster CLUSTER --domain DOMAIN [--hostname HOSTNAME] [--ip IP]
Cambio del dominio predeterminado de un clúster
El dominio Ingress predeterminado se utiliza para formar una URL única para cada una de sus aplicaciones y es el dominio al que hacen referencia las direcciones IP de cualquier ALB público de su clúster. Al suministrar un clúster, el dominio
de Ingress predeterminado se crea automáticamente, pero puede cambiar el dominio predeterminado por cualquier dominio que exista en el clúster. Para comprobar el dominio predeterminado del clúster, ejecute ibmcloud ks cluster get
y busque el subdominio de Ingress en la salida.
Para obtener más detalles y opciones de mandato, consulte la Referencia de CLI.
El dominio por defecto puede tardar hasta cinco minutos en actualizarse. Durante ese tiempo, es posible que el dominio experimente un tiempo de inactividad.
ibmcloud ks ingress domain default replace --cluster CLUSTER --domain DOMAIN
Gestión de secretos de dominio y certificados
Aprenda a gestionar el certificado TLS para el dominio de Ingress.
Regeneración del certificado para un dominio de entrada
Vuelva a generar el certificado de dominio para generar una nueva señal en el proveedor de DNS y aplíquelo al clúster.
Para obtener más detalles y opciones de mandato, consulte la Referencia de CLI
ibmcloud ks ingress domain secret regenerate --cluster CLUSTER --domain DOMAIN
Supresión de un secreto de dominio de Ingress
Elimina el secreto de un dominio de entrada e impide la futura renovación del certificado.
Para obtener más detalles y opciones de mandato, consulte la Referencia de CLI
ibmcloud ks ingress domain secret rm --cluster CLUSTER --domain DOMAIN