Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cree un clúster ROSA con HCP mediante la ROSA CLI
En las siguientes secciones se describe cómo empezar a utilizar ROSA con planos de control alojados (ROSA con HCP) mediante AWS STS la ROSA CLI. Para conocer los pasos para crear un ROSA con un clúster de HCP mediante Terraform, consulte la documentación de Red Hat
La ROSA CLI utiliza el auto modo o el manual modo para crear los IAM recursos y la configuración de OpenID Connect (OIDC) necesarios para crear un. ROSA
clústerautoel modo crea automáticamente las IAM funciones y políticas requeridas y el proveedor de OIDC. manualEl modo genera los AWS CLI comandos necesarios para crear los IAM recursos manualmente. Al usar manual el modo, puede revisar los AWS CLI comandos generados antes de ejecutarlos manualmente. Con el modo manual, también puede pasar los comandos a otro administrador o grupo de su organización para que pueda crear los recursos.
Los procedimientos de este documento utilizan el auto modo de la ROSA CLI para crear los IAM recursos necesarios y la configuración OIDC para ROSA con HCP. Para ver más opciones para empezar, consulte. Comience con ROSA
Temas
Requisitos previos
Complete las acciones previas que se enumeran enConfigurar para usar ROSA.
Cree una Amazon VPC arquitectura
El siguiente procedimiento crea una Amazon VPC arquitectura que se puede utilizar para alojar un clúster. Todos clúster los recursos están alojados en la subred privada. La subred pública enruta el tráfico saliente de la subred privada a través de una puerta de enlace NAT a la Internet pública. En este ejemplo, se utiliza 10.0.0.0/16 con bloque de CIDR para la Amazon VPC. Sin embargo, puede elegir otro bloque de CIDR. Para obtener más información, consulte Tamaño de la VPC.
importante
Si no se Amazon VPC cumplen los requisitos, se produce un error en la creación del clúster.
ejemplo
Cree los IAM roles necesarios y la configuración de OpenID Connect
Antes de crear un clúster ROSA con HCP, debe crear las IAM funciones y políticas necesarias y la configuración de OpenID Connect (OIDC). Para obtener más información sobre las IAM funciones y políticas de ROSA con HCP, consulte. AWS políticas administradas para ROSA
Este procedimiento utiliza el auto modo de la ROSA CLI para crear automáticamente la configuración OIDC necesaria para crear un ROSA con un clúster de HCP.
-
Cree las políticas y funciones de IAM cuenta necesarias. El
--force-policy-creationparámetro actualiza todos los roles y políticas existentes que estén presentes. Si no hay roles ni políticas, el comando crea estos recursos en su lugar.rosa create account-roles --force-policy-creationnota
Si el token de acceso sin conexión ha caducado, la ROSA CLI muestra un mensaje de error que indica que el token de autorización debe actualizarse. Para ver los pasos para solucionar problemas, consulteSolucionar problemas con los tokens de acceso sin conexión caducados por ROSA CLI.
-
Cree la configuración de OpenID Connect (OIDC) que permita la autenticación de los usuarios en el clúster. Esta configuración está registrada para usarse con OpenShift Cluster Manager (OCM).
rosa create oidc-config --mode=auto -
Copie el ID de configuración del OIDC que se proporciona en la salida de la ROSA CLI. El ID de configuración de OIDC debe proporcionarse más adelante para crear el clúster de ROSA con HCP.
-
Para verificar las configuraciones OIDC disponibles para los clústeres asociados a su organización de usuarios, ejecute el siguiente comando.
rosa list oidc-config -
Cree los roles de IAM operador necesarios y sustitúyalos por
<OIDC_CONFIG_ID>el ID de configuración del OIDC copiado anteriormente.ejemplo
importante
Debe proporcionar un prefijo en
<PREFIX_NAME>al crear los roles de operador. Si no se realiza esta acción, se producirá un error.rosa create operator-roles --prefix <PREFIX_NAME> --oidc-config-id <OIDC_CONFIG_ID> --hosted-cp -
Para comprobar que se crearon las funciones de IAM operador, ejecute el siguiente comando:
rosa list operator-roles
Cree un clúster ROSA con HCP mediante la ROSA CLI y AWS STS
Puede crear una ROSA con HCP clúster mediante AWS Security Token Service (AWS STS) y el auto modo que se proporciona en la ROSA CLI. Tiene la opción de crear un clúster con una API pública e Ingress o una API privada e Ingress.
Puede crear una clúster con una única zona de disponibilidad (Single-AZ) o múltiples zonas de disponibilidad (Multi-AZ). En cualquier caso, el valor de CIDR de su máquina debe coincidir con el valor de CIDR de su VPC.
El siguiente procedimiento utiliza el rosa create cluster --hosted-cp comando para crear una ROSA en una única zona de disponibilidad con HCP. clúster Para crear una zona de disponibilidad múltiple clúster, especifique multi-az en el comando y la subred privada de cada subred IDs privada en la que desee realizar el despliegue.
-
Cree un clúster de ROSA con HCP con uno de los siguientes comandos.
-
Cree un clúster ROSA con HCP con una API pública e Ingress, especificando el nombre del clúster, el prefijo del rol del operador, el ID de configuración del OIDC y la subred pública y privada. IDs
rosa create cluster --cluster-name=<CLUSTER_NAME> --sts --mode=auto --hosted-cp --operator-roles-prefix <OPERATOR_ROLE_PREFIX> --oidc-config-id <OIDC_CONFIG_ID> --subnet-ids=<PUBLIC_SUBNET_ID>,<PRIVATE_SUBNET_ID> -
Cree un clúster ROSA con HCP con una API privada e Ingress, especificando el nombre del clúster, el prefijo del rol de operador, el ID de configuración del OIDC y la subred privada. IDs
rosa create cluster --private --cluster-name=<CLUSTER_NAME> --sts --mode=auto --hosted-cp --subnet-ids=<PRIVATE_SUBNET_ID>
-
-
Comprueba el estado de tu. clúster
rosa describe cluster -c <CLUSTER_NAME>nota
Si el proceso de creación falla o el
Statecampo no cambia a un estado listo después de 10 minutos, consulteResolución de problemas.Para ponerse en contacto con Soporte el servicio de asistencia de Red Hat, consulteObtener ROSA apoyo.
-
Realice un seguimiento del progreso de la clúster creación observando los registros del OpenShift instalador.
rosa logs install -c <CLUSTER_NAME> --watch
Configure un proveedor de identidades y conceda el clúster acceso
ROSA incluye un OAuth servidor integrado. Una vez creado clúster el suyo, debe configurarlo OAuth para usar un proveedor de identidades. A continuación, puede añadir usuarios a su proveedor de identidad configurado para concederles acceso a su clúster. Puede otorgarles permisos de cluster-admin o dedicated-admin a estos usuarios según sea necesario.
Puede configurar diferentes tipos de proveedores de identidad para su clúster de ROSA . Los tipos compatibles incluyen GitHub Enterprise GitHub, Google GitLab, LDAP, OpenID Connect y proveedores de identidad. HTPasswd
importante
El proveedor de HTPasswd identidad se incluye solo para permitir la creación de un único usuario administrador estático. HTPasswd no se admite como proveedor de identidades de uso general para. ROSA
El siguiente procedimiento configura un proveedor de GitHub identidades como ejemplo. Para obtener instrucciones sobre cómo configurar cada uno de los tipos de proveedores de identidad compatibles, consulte Configuración de proveedores de identidad para AWS STS
-
Ve a github.com
e inicia sesión en tu cuenta. GitHub -
Si no tienes una GitHub organización que puedas usar para el aprovisionamiento de identidades, crea una. clúster Para obtener más información, consulta los pasos de la GitHub documentación
. -
Con el modo interactivo de la ROSA CLI, configure un proveedor de identidades para el clúster.
rosa create idp --cluster=<CLUSTER_NAME> --interactive -
Siga las instrucciones de configuración del resultado para restringir el clúster acceso a los miembros de su GitHub organización.
I: Interactive mode enabled. Any optional fields can be left empty and a default will be selected. ? Type of identity provider: github ? Identity provider name: github-1 ? Restrict to members of: organizations ? GitHub organizations: <GITHUB_ORG_NAME> ? To use GitHub as an identity provider, you must first register the application: - Open the following URL: https://github.com/organizations/<GITHUB_ORG_NAME>/settings/applications/new?oauth_application%5Bcallback_url%5D=https%3A%2F%2Foauth-openshift.apps.<CLUSTER_NAME>/<RANDOM_STRING>.p1.openshiftapps.com%2Foauth2callback%2Fgithub-1&oauth_application%5Bname%5D=<CLUSTER_NAME>&oauth_application%5Burl%5D=https%3A%2F%2Fconsole-openshift-console.apps.<CLUSTER_NAME>/<RANDOM_STRING>.p1.openshiftapps.com - Click on 'Register application' ... -
Abre la URL en el resultado y
<GITHUB_ORG_NAME>sustitúyela por el nombre de tu GitHub organización. -
En la página GitHub web, elija Registrar aplicación para registrar una nueva OAuth aplicación en su GitHub organización.
-
Utilice la información de la GitHub OAuth página para rellenar el resto de las solicitudes
rosa create idpinteractivas ejecutando el siguiente comando. Sustituya<GITHUB_CLIENT_ID>y por<GITHUB_CLIENT_SECRET>las credenciales de su aplicación. GitHub OAuth... ? Client ID: <GITHUB_CLIENT_ID> ? Client Secret: [? for help] <GITHUB_CLIENT_SECRET> ? GitHub Enterprise Hostname (optional): ? Mapping method: claim I: Configuring IDP for cluster '<CLUSTER_NAME>' I: Identity Provider 'github-1' has been created. It will take up to 1 minute for this configuration to be enabled. To add cluster administrators, see 'rosa grant user --help'. To login into the console, open https://console-openshift-console.apps.<CLUSTER_NAME>.<RANDOM_STRING>.p1.openshiftapps.com and click on github-1.nota
La configuración del proveedor de identidad puede tardar aproximadamente dos minutos en activarse. Si configuraste un
cluster-adminusuario, puedes correroc get pods -n openshift-authentication --watchpara ver cómo se vuelven a implementar los OAuth pods con la configuración actualizada. -
Compruebe que el proveedor de identidad esté configurado correctamente.
rosa list idps --cluster=<CLUSTER_NAME>
Conceda al usuario acceso a un clúster
Puede conceder acceso a un usuario al suyo clúster agregándolo al proveedor de identidades configurado.
El siguiente procedimiento agrega un usuario a una GitHub organización que está configurada para el aprovisionamiento de identidades en el clúster.
-
Ve a github.com
e inicia sesión en tu cuenta. GitHub -
Invita a los usuarios que necesiten clúster acceder a tu organización. GitHub Para obtener más información, consulte Invitar a los usuarios a unirse a su organización
en la GitHub documentación.
Configuración de permisos de cluster-admin
-
Otorgue los permisos de
cluster-adminmediante el siguiente comando. Sustituya<IDP_USER_NAME>y<CLUSTER_NAME>por su nombre de usuario y clúster.rosa grant user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME> -
Compruebe que el usuario aparezca como miembro del grupo de
cluster-admins.rosa list users --cluster=<CLUSTER_NAME>
Configuración de permisos de dedicated-admin
-
Otorgue los permisos de
dedicated-adminmediante el siguiente comando. Sustituya<IDP_USER_NAME>y<CLUSTER_NAME>por su clúster nombre de usuario mediante la ejecución del siguiente comando.rosa grant user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME> -
Compruebe que el usuario aparezca como miembro del grupo de
cluster-admins.rosa list users --cluster=<CLUSTER_NAME>
Acceda a a clúster a través de la consola Red Hat Hybrid Cloud
Inicie sesión en su consola a clúster través de Red Hat Hybrid Cloud Console.
-
Obtenga la URL de su consola clúster mediante el siguiente comando.
<CLUSTER_NAME>Reemplácela por el nombre de su clúster.rosa describe cluster -c <CLUSTER_NAME> | grep Console -
Navegue hasta la URL de la consola en la salida e inicie sesión.
En el cuadro de diálogo Iniciar sesión con..., seleccione el nombre del proveedor de identidad y complete las solicitudes de autorización de su proveedor.
Implemente una aplicación del catálogo para desarrolladores
Desde la consola de la nube híbrida de Red Hat, puede implementar una aplicación de prueba del catálogo de desarrolladores y exponerla con una ruta.
-
Diríjase a la Consola de la nube híbrida de Red Hat
y seleccione el clúster en el que desea implementar la aplicación. -
En la página del clúster, seleccione Abrir consola.
-
Desde la perspectiva Administrador, seleccione Inicio > Proyectos > Crear proyecto.
-
Introduzca un nombre para el proyecto y, si lo desea, añada un Nombre de visualización y una Descripción.
-
Seleccione Crear para crear el proyecto.
-
Cambie a la perspectiva Desarrollador y seleccione +Añadir. Asegúrese de que el proyecto seleccionado sea el que se acaba de crear.
-
En el cuadro de diálogo del Catálogo de desarrolladores, seleccione Todos los servicios.
-
En la página del catálogo para desarrolladores, seleccione Idiomas > en el JavaScriptmenú.
-
Elija Node.js y, a continuación, elija Crear aplicación para abrir la página Crear Source-to-Image aplicación.
nota
Puede que tenga que seleccionar Eliminar todos los filtros para que aparezca la opción Node.js.
-
En la sección Git, seleccione Probar ejemplo.
-
En el campo Nombre, agregue un nombre único.
-
Seleccione Crear.
nota
La nueva aplicación tarda varios minutos en implementarse.
-
Una vez finalizada la implementación, elija la URL de la ruta para la aplicación.
Se abre una nueva pestaña en el navegador con un mensaje similar al siguiente.
Welcome to your Node.js application on OpenShift -
(Opcional) Elimine la aplicación y limpie los recursos:
-
Desde la perspectiva de Administrador, seleccione Inicio > Proyectos.
-
Abra el menú de acciones del proyecto y seleccione Eliminar proyecto.
-
Revoque los permisos de cluster-admin de un usuario
-
Otorgue los permisos de
cluster-adminmediante el siguiente comando. Sustituya<IDP_USER_NAME>y<CLUSTER_NAME>por su clúster nombre de usuario.rosa revoke user cluster-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME> -
Compruebe que el usuario no figure como miembro del grupo de
cluster-admins.rosa list users --cluster=<CLUSTER_NAME>
Revoque los permisos de dedicated-admin de un usuario
-
Revoque los permisos de
dedicated-adminmediante el siguiente comando. Sustituya<IDP_USER_NAME>y<CLUSTER_NAME>por su clúster nombre de usuario.rosa revoke user dedicated-admin --user=<IDP_USER_NAME> --cluster=<CLUSTER_NAME> -
Compruebe que el usuario no figure como miembro del grupo
dedicated-admins.rosa list users --cluster=<CLUSTER_NAME>
Revocar el acceso del usuario a un clúster
Puede revocar el clúster acceso de un usuario del proveedor de identidades quitándolo del proveedor de identidades configurado.
Puede configurar diferentes tipos de proveedores de identidad para su clúster. El siguiente procedimiento revoca el clúster acceso de un miembro de una GitHub organización.
-
Ve a github.com
e inicia sesión en tu cuenta. GitHub -
Elimina al usuario de tu organización. GitHub Para obtener más información, consulte Eliminar a un miembro de su organización
en la GitHub documentación.
Eliminar un clúster y sus AWS STS recursos
Puede usar la ROSA CLI para eliminar una clúster que use AWS Security Token Service (AWS STS). También puede usar la ROSA CLI para eliminar las IAM funciones y el proveedor de OIDC creados por. ROSA Para eliminar las IAM políticas creadas por ROSA, puede utilizar la IAM consola.
nota
IAM las funciones y políticas creadas por ROSA pueden ser utilizadas por otros ROSA clústeres de la misma cuenta.
-
Elimine los registros clúster y observe los mismos. Sustituya
<CLUSTER_NAME>por el nombre o ID del clúster.rosa delete cluster --cluster=<CLUSTER_NAME> --watchimportante
Debe esperar clúster a que se eliminen por completo antes de eliminar las IAM funciones, las políticas y el proveedor de OIDC. Los roles de IAM de la cuenta son necesarios para eliminar los recursos creados por el instalador. Las funciones de IAM de los operadores son necesarias para limpiar los recursos creados por los operadores. OpenShift Los operadores utilizan el proveedor de OIDC para autenticar.
-
Elimine el proveedor de OIDC que utilizan los clúster operadores para autenticarse ejecutando el siguiente comando.
rosa delete oidc-provider -c <CLUSTER_ID> --mode auto -
Elimine las funciones de operador específicas del clúster. IAM
rosa delete operator-roles -c <CLUSTER_ID> --mode auto -
Elimine los roles de IAM de la cuenta mediante el siguiente comando. Sustituya
<PREFIX>por el prefijo de los roles de IAM de la cuenta que desea eliminar. Si especificó un prefijo personalizado al crear los roles de IAM de la cuenta, especifique el prefijo predeterminado deManagedOpenShift.rosa delete account-roles --prefix <PREFIX> --mode auto -
Elimine las IAM políticas creadas por. ROSA
-
Inicie sesión en la consola de IAM
. -
En el menú Administración de acceso de la izquierda, seleccione Políticas.
-
Seleccione la política que desea eliminar y elija Acciones > Eliminar.
-
Introduzca el nombre de la política y seleccione Eliminar.
-
Repita este paso para eliminar cada una de las políticas de IAM para el clúster.
-