Accueiil
Products
Red Hat OpenShift Service on AWS
4
Les outils CLI
8.2. Gérer les objets avec le ROSA CLI

8.2. Gérer les objets avec le ROSA CLI

Gérer les objets avec Red Hat OpenShift Service sur AWS (ROSA) CLI, rosa, tels que l’ajout d’utilisateurs admin dédiés, la gestion de clusters et la planification des mises à niveau des clusters.

Note

Afin d’accéder à un cluster accessible uniquement sur un serveur proxy HTTP, vous pouvez définir les variables HTTP_PROXY, HTTPS_PROXY et NO_PROXY. Ces variables d’environnement sont respectées par la rosa CLI de sorte que toute communication avec le cluster passe par le proxy HTTP.

8.2.1. Commandes et arguments communs
Copier lien

Ces commandes et arguments communs sont disponibles pour le Red Hat OpenShift Service sur AWS (ROSA) CLI, rosa.

8.2.1.1. débogage
Copier lien

Active le mode débogage pour la commande parent pour aider au dépannage.

Exemple :

rosa create cluster --cluster-name=<cluster_name> --debug

$ rosa create cluster --cluster-name=<cluster_name> --debug

Copy to Clipboard

Toggle word wrap

8.2.1.2. à télécharger
Copier lien

Télécharge la dernière version compatible du logiciel spécifié dans le répertoire actuel dans un fichier d’archives. Extrayez le contenu de l’archive et ajoutez le contenu à votre chemin d’utilisation pour utiliser le logiciel. Afin de télécharger la dernière ROSA CLI, spécifiez rosa. Afin de télécharger le dernier OpenShift CLI, spécifiez oc.

Exemple :

rosa download <software>

$ rosa download <software>

Copy to Clipboard

Toggle word wrap

8.2.1.3. aide
Copier lien

Affiche les informations générales d’aide pour le ROSA CLI (rosa) et une liste de commandes disponibles. Cette option peut également être utilisée comme argument pour afficher des informations d’aide pour une commande parente, comme la version ou la création.

Exemples

Affiche l’aide générale pour le ROSA CLI.

rosa --help

$ rosa --help

Copy to Clipboard

Toggle word wrap

Affiche l’aide générale pour la version.

rosa version --help

$ rosa version --help

Copy to Clipboard

Toggle word wrap

8.2.1.4. interactif
Copier lien

Active le mode interactif.

Exemple :

rosa create cluster --cluster-name=<cluster_name> --interactive

$ rosa create cluster --cluster-name=<cluster_name> --interactive

Copy to Clipboard

Toggle word wrap

8.2.1.5. le profil
Copier lien

Indique un profil AWS à partir de votre fichier d’identification.

Exemple :

rosa create cluster --cluster-name=<cluster_name> --profile=myAWSprofile

$ rosa create cluster --cluster-name=<cluster_name> --profile=myAWSprofile

Copy to Clipboard

Toggle word wrap

8.2.1.6. la version
Copier lien

Affiche la version rosa et vérifie si une version plus récente est disponible.

Exemple :

rosa version [arguments]

$ rosa version [arguments]

Copy to Clipboard

Toggle word wrap

Exemple de sortie

Affiché lorsqu’une version plus récente du ROSA CLI est disponible.

1.2.12
There is a newer release version '1.2.15', please consider updating: https://mirror.openshift.com/pub/openshift-v4/clients/rosa/latest/

1.2.12
There is a newer release version '1.2.15', please consider updating: https://mirror.openshift.com/pub/openshift-v4/clients/rosa/latest/

Copy to Clipboard

Toggle word wrap

8.2.2. Commandes parentes
Copier lien

Le Red Hat OpenShift Service sur AWS (ROSA) CLI, rosa, utilise des commandes parentales avec des commandes enfant pour gérer les objets. Les commandes parentes créent, modifient, suppriment, listent et décrivent. Les commandes parent ne peuvent pas toutes être utilisées avec toutes les commandes enfant. Consultez les sujets de référence spécifiques qui décrivent les commandes enfant.

8.2.2.1. créer
Copier lien

Crée un objet ou une ressource lorsqu’il est associé à une commande enfant.

Exemple :

rosa create cluster --cluster-name=mycluster

$ rosa create cluster --cluster-name=mycluster

Copy to Clipboard

Toggle word wrap

8.2.2.2. Editer
Copier lien

Edite des options pour un objet, comme rendre un cluster privé.

Exemple :

rosa edit cluster --cluster=mycluster --private

$ rosa edit cluster --cluster=mycluster --private

Copy to Clipboard

Toggle word wrap

8.2.2.3. effacer
Copier lien

Supprime un objet ou une ressource lorsqu’il est associé à une commande enfant.

Exemple :

rosa delete ingress --cluster=mycluster

$ rosa delete ingress --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.2.4. liste
Copier lien

Liste des clusters ou des ressources pour un cluster spécifique.

Exemple :

rosa list users --cluster=mycluster

$ rosa list users --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.2.5. décrire
Copier lien

Affiche les détails d’un cluster.

Exemple :

rosa describe cluster --cluster=mycluster

$ rosa describe cluster --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.3. Créer des objets
Copier lien

Cette section décrit les commandes de création de clusters et de ressources.

8.2.3.1. créer des rôles de compte
Copier lien

Créez le rôle et les ressources stratégiques nécessaires à l’ensemble du compte pour votre cluster.

Syntaxe

rosa create account-roles [flags]

$ rosa create account-roles [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.11. Drapeaux
L’option	Définition
--debug	Activer le mode débogage.
-I, --interactif	Activer le mode interactif.
-M, --mode chaîne	Comment effectuer l’opération. Les options valides sont: `l’auto` Les modifications de ressources seront automatiquement appliquées à l’aide du compte AWS actuel. `le manuel` Les commandes nécessaires pour modifier les ressources AWS seront exécutées manuellement.
--chaîne de chemin	Le chemin Amazon Resource Name (ARN) pour les rôles et les politiques à l’échelle du compte, y compris les politiques d’opérateur.
--permissions-chaînes limitrophes	L’ARN de la stratégie utilisée pour définir la limite des autorisations pour les rôles de compte.
--chaîne de préfixe	Le préfixe défini par l’utilisateur pour toutes les ressources AWS générées. La valeur par défaut est ManagedOpenShift.
--fichier de chaîne	Utilisez un profil AWS spécifique à partir de votre fichier d’identification.
-y, --oui	Automatiquement répondre oui pour confirmer les opérations.

8.2.3.2. créer un administrateur
Copier lien

Créez un administrateur de cluster avec un mot de passe généré automatiquement qui peut se connecter à un cluster.

Syntaxe

rosa create admin --cluster=<cluster_name>|<cluster_id>

$ rosa create admin --cluster=<cluster_name>|<cluster_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.12. Arguments
L’option	Définition
--cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID (chaîne) du cluster à ajouter au fournisseur d’identité (IDP).

Expand

Tableau 8.13. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--fichier de chaîne	Indique un profil AWS à partir de votre fichier d’identification.

Exemple :

Créez un administrateur de cluster qui peut se connecter à un cluster nommé mycluster.

rosa create admin --cluster=mycluster

$ rosa create admin --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.3.3. créer des informations d’identification en verre cassé
Copier lien

Créez un identifiant de verre de rupture pour un cluster de plan de contrôle hébergé avec authentification externe activée.

Syntaxe

rosa create break-glass-credential --cluster=<cluster_name> [arguments]

$ rosa create break-glass-credential --cluster=<cluster_name> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.14. Arguments
L’option	Définition
--cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’identifiant du cluster auquel sera ajouté l’identifiant de verre cassé.
-- périmés	Facultatif: Combien de temps un identifiant de verre de rupture peut être utilisé avant d’expirer. La durée d’expiration doit être d’un minimum de 10 minutes et d’un maximum de 24 heures. Dans le cas où vous n’enregistrez pas de valeur, la durée d’expiration par défaut est de 24 heures.
--nom d’utilisateur	En option. Le nom d’utilisateur de l’identifiant de verre cassé. Lorsque vous n’entrez pas une valeur, un nom d’utilisateur aléatoire est généré pour vous.

Expand

Tableau 8.15. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
--région	Indique une région AWS, dépassant la variable d’environnement AWS_REGION.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemples

Ajoutez un identifiant de verre cassé à un cluster nommé mycluster.

Syntaxe

rosa create break-glass-credential --cluster=mycluster

$ rosa create break-glass-credential --cluster=mycluster

Copy to Clipboard

Toggle word wrap

Ajoutez un identifiant de verre de rupture à un cluster nommé mycluster en utilisant le mode interactif.

Syntaxe

rosa create break-glass-credential --cluster=mycluster -i

$ rosa create break-glass-credential --cluster=mycluster -i

Copy to Clipboard

Toggle word wrap

8.2.3.4. créer un cluster
Copier lien

Créez un nouveau cluster.

Syntaxe

rosa create cluster --cluster-name=<cluster_name> [arguments]

$ rosa create cluster --cluster-name=<cluster_name> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.16. Arguments
L’option	Définition
--addition-compute-sécurité-groupe-ids <sec_group_id>	L’identifiant d’un ou plusieurs groupes de sécurité supplémentaires à utiliser avec les groupes de sécurité par défaut qui sont utilisés avec le pool de machines standard créé à côté du cluster. Afin d’obtenir de plus amples renseignements sur d’autres groupes de sécurité, consultez les exigences relatives aux groupes de sécurité au titre des ressources supplémentaires.
--addition-infra-sécurité-groupe-id> <sec_group_id>	L’identifiant d’un ou plusieurs groupes de sécurité supplémentaires à utiliser avec les groupes de sécurité par défaut qui sont utilisés avec les nœuds infras créés à côté du cluster. Afin d’obtenir de plus amples renseignements sur d’autres groupes de sécurité, consultez les exigences relatives aux groupes de sécurité au titre des ressources supplémentaires.
--addition-contrôle-plan-sécurité-groupe-id> <sec_group_id>	L’identifiant d’un ou plusieurs groupes de sécurité supplémentaires à utiliser avec les groupes de sécurité par défaut qui sont utilisés avec les nœuds de plan de contrôle créés à côté du cluster. Afin d’obtenir de plus amples renseignements sur d’autres groupes de sécurité, consultez les exigences relatives aux groupes de sécurité au titre des ressources supplémentaires.
--supplément-permis-principaux <arn>	Liste séparée par virgule des ARN principaux supplémentaires autorisés à être ajoutés au service de point de terminaison VPC du plan de contrôle hébergé pour permettre l’acceptation automatique des demandes de connexion de point de terminaison VPC supplémentaires.
--cluster-name <cluster_name>	C’est nécessaire. Le nom du cluster. Lorsqu’il est utilisé avec la commande de cluster de création, cet argument est utilisé pour définir le nom du cluster et peut contenir jusqu’à 54 caractères. La valeur de cet argument doit être unique au sein de votre organisation.
--compute-machine-type <instance_type>	Le type d’instance pour calculer les nœuds dans le cluster. Cela détermine la quantité de mémoire et de vCPU qui est allouée à chaque nœud de calcul. Consultez les types d’instance AWS dans la définition de service ROSA pour plus d’informations sur les types d’instances valides.
--ControlPlane-iam-role <arn>	L’ARN du rôle de l’IAM à attacher aux instances de contrôle du plan.
--créer-cluster-admin	En option. Dans le cadre de la création de clusters, créez un utilisateur administrateur local (cluster-admin) pour votre cluster. Cela configure automatiquement un fournisseur d’identité htpasswd pour l’utilisateur cluster-admin. En option, utilisez les options --cluster-admin-user et --cluster-admin-password pour spécifier le nom d’utilisateur et le mot de passe pour l’utilisateur administrateur. L’omission de ces options génère automatiquement les informations d’identification et affiche leurs valeurs en tant que sortie terminale.
--cluster-admin-user	En option. Indique le nom d’utilisateur de l’utilisateur administrateur du cluster créé lorsqu’il est utilisé en conjonction avec l’option --create-cluster-admin.
--cluster-admin-password	En option. Indique le mot de passe de l’utilisateur administrateur du cluster créé lorsqu’il est utilisé conjointement avec l’option --create-cluster-admin.
--désable-scp-checks	Indique si les contrôles d’autorisation dans le cloud sont désactivés lors de la tentative d’installation d’un cluster.
--dry-run	Il simule la création du cluster.
--domaine-préfixe	Facultatif: Lorsqu’il est utilisé avec la commande de cluster de création, cet argument définit le sous-domaine de votre cluster sur *.openshiftapps.com. La valeur de cet argument doit être unique au sein de votre organisation, ne peut pas dépasser 15 caractères et ne peut pas être modifiée après la création de clusters. Lorsque l’argument n’est pas fourni, une valeur générée automatiquement est créée qui dépend de la longueur du nom du cluster. Lorsque le nom du cluster est inférieur ou égal à 15 caractères, ce nom est utilisé pour le préfixe de domaine. Lorsque le nom du cluster est supérieur à 15 caractères, le préfixe de domaine est généré au hasard sur une chaîne de 15 caractères.
--ec2-metadata-http-tokens chaîne	Configure l’utilisation d’IMDSv2 pour les instances EC2. Les valeurs valides sont facultatives (par défaut) ou requises.
--enable-autoscaling	Active la mise à l’échelle automatique des nœuds de calcul. La mise à l’échelle automatique par défaut est définie sur 2 nœuds. Afin de définir des limites de nœuds non par défaut, utilisez cet argument avec les arguments --min-replicas et --max-replicas.
--etcd-encryption	Active le cryptage des valeurs clés ETCD sur Red Hat OpenShift Service sur les clusters AWS (architecture classique).
--etcd-encryption-kms-arn	Active le cryptage du stockage ETCD à l’aide de la clé gérée par le client gérée dans AWS Key Management Service.
--external-id <arn_string>	Identificateur unique optionnel qui pourrait être requis lorsque vous assumez un rôle dans un autre compte.
--host-prefix <subnet>	La longueur de préfixe de sous-réseau à attribuer à chaque nœud individuel, en tant qu’entier. Ainsi, si le préfixe hôte est défini à 23, chaque nœud reçoit un sous-réseau /23 à partir du CIDR donné.
--machine-cidr <address_block>	Bloc d’adresses IP (ipNet) utilisé par ROSA lors de l’installation du cluster, par exemple 10.0.0.0/16. Important En interne, OVN-Kubernetes, le fournisseur de réseau par défaut dans ROSA 4.11 et ultérieure, utilise la plage d’adresses IP 100.64.0.0/16. Lorsque votre cluster utilise OVN-Kubernetes, n’incluez pas la plage d’adresses IP 100.64.0.0/16 dans les autres définitions CIDR de votre cluster.
--Max-replicas <number_of_nodes>	Indique le nombre maximal de nœuds de calcul lors de l’activation de l’autoscaling. Défaut: 2
--min-replicas <number_of_nodes>	Indique le nombre minimum de nœuds de calcul lors de l’activation de l’autoscaling. Défaut: 2
--multi-az	Déploiement dans plusieurs centres de données.
--no-cni	Crée un cluster sans plugin Container Network Interface (CNI). Les clients peuvent ensuite apporter leur propre plugin CNI et l’installer après la création de clusters.
--operator-roles-prefix <string>	Le préfixe qui est utilisé pour tous les rôles IAM utilisés par les opérateurs nécessaires dans l’installateur OpenShift. Le préfixe est généré automatiquement si vous n’en spécifiez pas un.
--pod-cidr <address_block>	Bloc d’adresses IP (ipNet) à partir duquel les adresses IP pod sont allouées, par exemple 10.128.0.0/14. Important En interne, OVN-Kubernetes, le fournisseur de réseau par défaut dans ROSA 4.11 et ultérieure, utilise la plage d’adresses IP 100.64.0.0/16. Lorsque votre cluster utilise OVN-Kubernetes, n’incluez pas la plage d’adresses IP 100.64.0.0/16 dans les autres définitions CIDR de votre cluster.
--privé	Limite le point de terminaison principal de l’API et les itinéraires d’application à une connectivité directe et privée.
--lien privé	Indique l’utilisation d’AWS PrivateLink pour fournir une connectivité privée entre les VPC et les services. L’argument --subnet-ids est requis lors de l’utilisation -- private-link.
--région <région_name>	Le nom de la région AWS où votre pool de travailleurs sera situé, par exemple, us-est-1. Cet argument remplace la variable d’environnement AWS_REGION.
--répliques n	Le nombre de nœuds de travailleurs à disposition par zone de disponibilité. Les clusters d’une seule zone nécessitent au moins 2 nœuds. Les clusters multizones nécessitent au moins 3 nœuds. Défaut: 2 pour les clusters à zone unique; 3 pour les clusters multi-zones.
--rolle-arn <arn>	L’ARN du rôle d’installateur utilisé par OpenShift Cluster Manager pour créer le cluster. Ceci est requis si vous n’avez pas déjà créé de rôles de compte.
--service-cidr <address_block>	Bloc d’adresses IP (ipNet) pour les services, par exemple 172.30.0.0/16. Important En interne, OVN-Kubernetes, le fournisseur de réseau par défaut dans ROSA 4.11 et ultérieure, utilise la plage d’adresses IP 100.64.0.0/16. Lorsque votre cluster utilise OVN-Kubernetes, n’incluez pas la plage d’adresses IP 100.64.0.0/16 dans les autres définitions CIDR de votre cluster.
--STS \| --non-sts	Indique s’il faut utiliser AWS Security Token Service (STS) ou IAM (non-STS) pour déployer votre cluster.
--subnet-ids <aws_subnet_id>	Les ID de sous-réseau AWS qui sont utilisés lors de l’installation du cluster, par exemple, sous-net-01abc234d5678ef9a. Les ID de sous-réseau doivent être en paires avec un identifiant de sous-réseau privé et un identifiant de sous-réseau public par zone de disponibilité. Les sous-réseaux sont délimités par virgule, par exemple --subnet-ids=subnet-1,subnet-2. Laissez la valeur vide pour les ID de sous-réseau fournis par l’installateur. Lorsque vous utilisez -- private-link, l’argument --subnet-ids est requis et un seul sous-réseau privé est autorisé par zone.
--support-role-arn chaîne	L’ARN du rôle utilisé par Red Hat Site Reliability Engineers (SRE) pour permettre l’accès au compte cluster pour fournir un support.
--tags	Balises utilisées sur les ressources créées par Red Hat OpenShift Service sur AWS dans AWS. Les balises peuvent vous aider à gérer, identifier, organiser, rechercher et filtrer les ressources au sein d’AWS. Les étiquettes sont séparées par virgule, par exemple: "valeur clé, foo bar". Important Le service Red Hat OpenShift sur AWS ne prend en charge que les balises personnalisées des ressources Red Hat OpenShift lors de la création de clusters. Lorsqu’ils ont été ajoutés, les balises ne peuvent pas être supprimées ou modifiées. Les balises ajoutées par Red Hat sont nécessaires pour que les clusters restent en conformité avec les accords de niveau de production de Red Hat (SLA). Ces balises ne doivent pas être supprimées. Le service OpenShift Red Hat sur AWS ne prend pas en charge l’ajout de balises supplémentaires en dehors des ressources gérées par le cluster ROSA. Ces balises peuvent être perdues lorsque les ressources AWS sont gérées par le cluster ROSA. Dans ces cas, vous pourriez avoir besoin de solutions ou d’outils personnalisés pour réconcilier les balises et les garder intactes.
--version chaîne	La version de ROSA qui sera utilisée pour installer les ressources du cluster ou du cluster. Dans le cas d’un cluster, utilisez un format X.Y.Z, par exemple 4.18.0. Dans le cas du rôle de compte, utilisez un format X.Y, par exemple 4.18.
--worker-iam-role string	L’ARN du rôle IAM qui sera attaché aux instances de calcul.

Expand

Tableau 8.17. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Créez un cluster nommé mycluster.

rosa create cluster --cluster-name=mycluster

$ rosa create cluster --cluster-name=mycluster

Copy to Clipboard

Toggle word wrap

Créez un cluster avec une région AWS spécifique.

rosa create cluster --cluster-name=mycluster --region=us-east-2

$ rosa create cluster --cluster-name=mycluster --region=us-east-2

Copy to Clipboard

Toggle word wrap

Créez un cluster avec autoscaling activé sur le pool de machines de travail par défaut.

rosa create cluster --cluster-name=mycluster -region=us-east-1 --enable-autoscaling --min-replicas=2 --max-replicas=5

$ rosa create cluster --cluster-name=mycluster -region=us-east-1 --enable-autoscaling --min-replicas=2 --max-replicas=5

Copy to Clipboard

Toggle word wrap

8.2.3.5. créer un fournisseur externe
Copier lien

Ajoutez un fournisseur d’identité externe au lieu du serveur OpenShift OAuth2.

Important

Il est possible d’utiliser uniquement des fournisseurs d’authentification externes sur ROSA avec des clusters HCP.

Syntaxe

rosa create external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa create external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.18. Arguments
L’option	Définition
--claim-mapping-groups-claim <string>	C’est nécessaire. Décrit les règles sur la façon de transformer les informations d’un jeton ID en une identité de cluster.
--claim-validation-règle <strings>	Des règles qui sont appliquées pour valider les revendications de jetons pour authentifier les utilisateurs. L’entrée sera dans un format <claim>:<required_value>. Afin d’avoir plusieurs règles de validation des revendications, vous pouvez séparer les valeurs par ,. À titre d’exemple, <claim>:<required_value>,<claim>:<required_value>.
--claim-mapping-username-claim <string>	Le nom de la revendication qui devrait être utilisé pour construire des noms d’utilisateur pour l’identité du cluster.
--cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID du cluster auquel le PDI sera ajouté.
--console-client-id <string>	L’identifiant du client OIDC du fournisseur OIDC pour la console Web OpenShift Cluster Manager.
--console-client-secret <string>	Le secret associé à l’enregistrement de l’application console.
--Émetteur-audiences <strings>	Divers publics pour vérifier les jetons entrants contre. Les jetons valides doivent inclure au moins une de ces valeurs dans leur revendication d’audience.
--Émetteur-ca-file <string>	Le chemin d’accès au fichier de certificat encodé PEM à utiliser lors de la demande au serveur.
--émetteur-url <string>	L’URL de service de l’émetteur de jetons.
--nom <string>	Le nom utilisé pour désigner le fournisseur d’authentification externe.

Expand

Tableau 8.19. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique une chaîne de profil AWS à partir de votre fichier d’identification.

Exemples

Ajoutez un fournisseur d’identité Microsoft Entra ID à un cluster nommé mycluster.

rosa create external-auth-provider --cluster=mycluster --name <provider_name> --issuer-audiences <audience_id> --issuer-url <issuing id> --claim-mapping-username-claim email --claim-mapping-groups-claim groups

$ rosa create external-auth-provider --cluster=mycluster --name <provider_name> --issuer-audiences <audience_id> --issuer-url <issuing id> --claim-mapping-username-claim email --claim-mapping-groups-claim groups

Copy to Clipboard

Toggle word wrap

8.2.3.6. créer idp
Copier lien

Ajoutez un fournisseur d’identité (IDP) pour définir comment les utilisateurs se connectent à un cluster.

Syntaxe

rosa create idp --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa create idp --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.20. Arguments
L’option	Définition
--cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID du cluster auquel le PDI sera ajouté.
--ca <path_to_file>	Le chemin d’accès au fichier de certificat encodé PEM à utiliser lors de l’envoi de requêtes au serveur, par exemple, /usr/share/cert.pem.
--client-id	L’ID client (chaîne) de l’application enregistrée.
--client-secret	Le secret client (chaîne) de la demande enregistrée.
--mapping-méthod	Indique comment les nouvelles identités (chaînes) sont cartographiées aux utilisateurs lorsqu’ils se connectent. Défaut: réclamation
--nom	Le nom (chaîne) du fournisseur d’identité.
--type	Le type (chaîne) du fournisseur d’identité. Les options: github, gitlab, google, ldap, openid

Expand

Tableau 8.21. Arguments de GitHub
L’option	Définition
--nom d’hôte	Le domaine optionnel (chaîne) utilisé avec une instance hébergée de GitHub Enterprise.
--organisation	Indique les organisations pour l’accès à la connexion. Les utilisateurs qui sont membres d’au moins une des organisations listées (chaîne) sont seuls autorisés à se connecter.
--équipes	Indique les équipes pour l’accès à la connexion. Les utilisateurs qui sont membres d’au moins une des équipes listées (chaîne) sont seuls autorisés à se connecter. Le format est <org>/<équipe>.

Expand

Tableau 8.22. Arguments de GitLab
L’option	Définition
--host-url	L’URL hôte (chaîne) d’un fournisseur GitLab. Défaut: https://gitlab.com

Expand

Tableau 8.23. Arguments de Google
L’option	Définition
--domaine hébergé	Limite les utilisateurs à un domaine Google Apps (chaîne).

Expand

Tableau 8.24. Arguments LDAP
L’option	Définition
--bind-dn	Le nom de domaine (chaîne) à lier pendant la phase de recherche.
--bind-password	Le mot de passe (chaîne) à lier pendant la phase de recherche.
--email-attributs	La liste (chaîne) des attributs dont les valeurs doivent être utilisées comme adresse e-mail.
--ID-attributs	La liste (chaîne) des attributs dont les valeurs doivent être utilisées comme ID utilisateur. Défaut: dn
--insécurité	Il ne fait pas de connexions TLS au serveur.
--nom-attributs	La liste (chaîne) des attributs dont les valeurs doivent être utilisées comme nom d’affichage. Défaut: cn
--URL	La RFC 2255 URL (chaîne) qui spécifie les paramètres de recherche LDAP qui sont utilisés.
--nom d’utilisateur-attributs	La liste (chaîne) des attributs dont les valeurs doivent être utilisées comme nom d’utilisateur préféré. Défaut: uid

Expand

Tableau 8.25. Arguments OpenID
L’option	Définition
--email-claims	La liste (chaîne) des revendications qui sont utilisées comme adresse e-mail.
--extra-scopes	La liste (chaîne) des portées à demander, en plus de la portée openid, lors de la demande de jeton d’autorisation.
--émetteur-url	L’URL (chaîne) que le fournisseur OpenID affirme comme l’identifiant de l’émetteur. Il doit utiliser le schéma HTTPS sans paramètres de requête d’URL ou fragment.
--nom-revendications	La liste (chaîne) des revendications qui sont utilisées comme nom d’affichage.
--nom d’utilisateur-claims	La liste (chaîne) des revendications qui sont utilisées comme nom d’utilisateur préféré lors du provisionnement d’un utilisateur.
--groupes-revendications	La liste (chaîne) des revendications qui sont utilisées comme noms de groupes.

Expand

Tableau 8.26. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Ajoutez un fournisseur d’identité GitHub à un cluster nommé mycluster.

rosa create idp --type=github --cluster=mycluster

$ rosa create idp --type=github --cluster=mycluster

Copy to Clipboard

Toggle word wrap

Ajoutez un fournisseur d’identité à la suite d’invites interactives.

rosa create idp --cluster=mycluster --interactive

$ rosa create idp --cluster=mycluster --interactive

Copy to Clipboard

Toggle word wrap

8.2.3.7. créer une entrée
Copier lien

Ajoutez un point de terminaison d’entrée pour activer l’accès à l’API au cluster.

Syntaxe

rosa create ingress --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa create ingress --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.27. Arguments
L’option	Définition
--cluster <cluster_name>\|<cluster_id>	Le nom ou l’identifiant du cluster auquel l’entrée sera ajoutée.
--label-match	Le label match (corde) pour ingress. Le format doit être une liste délimitée par virgule de paires key=valeur. En l’absence d’étiquette, tous les itinéraires sont exposés sur les deux routeurs.
--privé	Limite l’itinéraire de l’application à la connectivité directe et privée.

Expand

Tableau 8.28. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Ajoutez une entrée interne à un cluster nommé mycluster.

rosa create ingress --private --cluster=mycluster

$ rosa create ingress --private --cluster=mycluster

Copy to Clipboard

Toggle word wrap

Ajoutez une entrée publique à un cluster nommé mycluster.

rosa create ingress --cluster=mycluster

$ rosa create ingress --cluster=mycluster

Copy to Clipboard

Toggle word wrap

Ajoutez une entrée avec un sélecteur d’itinéraire correspondant à l’étiquette.

rosa create ingress --cluster=mycluster --label-match=foo=bar,bar=baz

$ rosa create ingress --cluster=mycluster --label-match=foo=bar,bar=baz

Copy to Clipboard

Toggle word wrap

8.2.3.8. créer kubeletconfig
Copier lien

Créer un objet KubeletConfig personnalisé pour permettre la configuration personnalisée des nœuds dans un

Syntaxe

rosa create kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]

$ rosa create kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.29. Drapeaux
L’option	Définition
--pod-pids-limit <numéro>	C’est nécessaire. Le nombre maximal de PID pour chaque nœud dans le
-C, --cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID du cluster dans lequel créer l’objet KubeletConfig.
--nom	Indique un nom pour l’objet KubeletConfig.
-I, --interactif	Activer le mode interactif.
-h, --aide	Affiche l’aide pour cette commande.

Afin d’obtenir de plus amples informations sur la définition de la limite PID pour le cluster, consultez Configuring PID limites.

8.2.3.9. créer machinepool
Copier lien

Ajoutez un pool de machines à un cluster existant.

Syntaxe

rosa create machinepool --cluster=<cluster_name> | <cluster_id> --replicas=<number> --name=<machinepool_name> [arguments]

$ rosa create machinepool --cluster=<cluster_name> | <cluster_id> --replicas=<number> --name=<machinepool_name> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.30. Arguments
L’option	Définition
--addition-sécurité-groupe-ID <sec_group_id>	L’identifiant d’un ou plusieurs groupes de sécurité supplémentaires à utiliser avec les groupes de sécurité par défaut pour ce pool de machines. Afin d’obtenir de plus amples renseignements sur d’autres groupes de sécurité, consultez les exigences relatives aux groupes de sécurité au titre des ressources supplémentaires.
--cluster <cluster_name>\|<cluster_id>	Requis : le nom ou l’identifiant du cluster auquel le pool de machines sera ajouté.
--taille de disque	Définissez la taille du volume du disque pour le pool de machines, dans Gib ou TiB. La valeur par défaut est 300 GiB. Dans le cas des clusters ROSA (architecture classique) version 4.13 ou antérieures, la taille minimale du disque est de 128 GiB, et le maximum est de 1 TiB. En cluster version 4.14 et ultérieure, le minimum est 128 GiB, et le maximum est 16 TiB. Dans le cas de ROSA avec des clusters HCP, la taille minimale du disque est de 75 GiB, et le maximum est de 16 384 GiB.
--enable-autoscaling	Activer ou désactiver la mise à l’échelle automatique des nœuds de calcul. Afin d’activer l’autoscaling, utilisez cet argument avec les arguments --min-replicas et --max-replicas. Afin de désactiver l’autoscaling, utilisez --enable-autoscaling=false avec l’argument --replicas.
--instance-type	Le type d’instance (chaîne) qui doit être utilisé. Défaut: m5.xlarge
--kubelet-configs <kubeletconfig_name>	Dans le cas de Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), les noms des objets KubeletConfig s’appliquent aux nœuds d’un pool de machines.
--étiquettes	Les étiquettes (chaîne) pour la piscine de machines. Le format doit être une liste délimitée par virgule de paires key=valeur. Cette liste écrase les modifications apportées aux étiquettes des nœuds sur une base continue.
--max-replicas	Indique le nombre maximal de nœuds de calcul lors de l’activation de l’autoscaling.
--min-replicas	Indique le nombre minimum de nœuds de calcul lors de l’activation de l’autoscaling.
--Max-surge	Dans le cas de Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), le paramètre max-surge définit le nombre de nouveaux nœuds qui peuvent être fournis au-delà du nombre souhaité de répliques pour le pool de machines, comme configuré à l’aide du paramètre --replicas, ou tel que déterminé par l’autoscaler lorsque l’autoscaling est activé. Cela peut être un nombre absolu (par exemple, 2) ou un pourcentage de la taille du pool de la machine (par exemple, 20%), mais doit utiliser la même unité que le paramètre max-indisponible. La valeur par défaut est 1, ce qui signifie que le nombre maximum de nœuds dans le pool de machines lors d’une mise à niveau est de 1 plus le nombre de répliques souhaitée pour le pool de machines. Dans cette situation, un nœud excédentaire peut être fourni avant que les nœuds existants ne soient rendus indisponibles. Le nombre de nœuds qui peuvent être fournis simultanément lors d’une mise à niveau est max-surge plus max-indisponible.
--Max-indisponible	Dans le cas de Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), le paramètre max-indisponible définit le nombre de nœuds qui peuvent être rendus indisponibles dans un pool de machines lors d’une mise à niveau, avant que de nouveaux nœuds ne soient fournis. Cela peut être un nombre absolu (par exemple, 2) ou un pourcentage du nombre de répliques actuelles dans le pool de machines (par exemple, 20%), mais doit utiliser la même unité que le paramètre max-surge. La valeur par défaut est 0, ce qui signifie qu’aucun nœud obsolète n’est supprimé avant que de nouveaux nœuds ne soient provisionnés. La plage valide pour cette valeur est de 0 à la taille actuelle de la machine, ou de 0% à 100%. Le nombre total de nœuds qui peuvent être mis à niveau simultanément lors d’une mise à niveau est max-surge plus max-indisponible.
--nom	Requis: Le nom (chaîne) pour la piscine de la machine.
--répliques	Lorsque l’autoscaling n’est pas configuré. Le nombre (integer) de machines pour ce pool de machines.
--tags	Appliquez des balises définies par l’utilisateur à toutes les ressources créées par ROSA dans AWS. Les étiquettes sont séparées par des virgules, par exemple: 'valeur clé, foo bar'.
--tains	Des taintes pour la piscine de machines. Cette valeur de chaîne doit être formatée sous la forme d’une liste séparée par virgule de key=value:ScheduleType. Cette liste écrasera les modifications apportées aux taches de nœud sur une base continue.

Expand

Tableau 8.31. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Ajoutez de manière interactive un pool de machines à un cluster nommé mycluster.

rosa create machinepool --cluster=mycluster --interactive

$ rosa create machinepool --cluster=mycluster --interactive

Copy to Clipboard

Toggle word wrap

Ajoutez un pool de machines nommé mp-1 à un cluster avec autoscaling activé.

rosa create machinepool --cluster=mycluster --enable-autoscaling --min-replicas=2 --max-replicas=5 --name=mp-1

$ rosa create machinepool --cluster=mycluster --enable-autoscaling --min-replicas=2 --max-replicas=5 --name=mp-1

Copy to Clipboard

Toggle word wrap

Ajoutez un pool de machines nommé mp-1 avec 3 répliques de m5.xlarge à un cluster.

rosa create machinepool --cluster=mycluster --replicas=3 --instance-type=m5.xlarge --name=mp-1

$ rosa create machinepool --cluster=mycluster --replicas=3 --instance-type=m5.xlarge --name=mp-1

Copy to Clipboard

Toggle word wrap

Ajoutez un pool de machines (mp-1) à un Red Hat OpenShift Service sur AWS (ROSA) avec cluster de plans de contrôle hébergés (HCP), configurant 6 répliques et le comportement de mise à niveau suivant:

Autoriser jusqu’à 2 nœuds excédentaires à provisionner lors d’une mise à niveau.
Assurez-vous qu’au plus 3 nœuds ne sont pas disponibles lors d’une mise à niveau.

rosa create machinepool --cluster=mycluster --replicas=6 --name=mp-1 --max-surge=2 --max-unavailable=3

$ rosa create machinepool --cluster=mycluster --replicas=6 --name=mp-1 --max-surge=2 --max-unavailable=3

Copy to Clipboard

Toggle word wrap

Ajoutez un pool de machines avec des étiquettes à un cluster.

rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --labels=foo=bar,bar=baz --name=mp-1

$ rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --labels=foo=bar,bar=baz --name=mp-1

Copy to Clipboard

Toggle word wrap

Ajoutez un pool de machines avec des étiquettes à un cluster.

rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --tags='foo bar,bar baz' --name=mp-1

$ rosa create machinepool --cluster=mycluster --replicas=2 --instance-type=r5.2xlarge --tags='foo bar,bar baz' --name=mp-1

Copy to Clipboard

Toggle word wrap

8.2.3.10. créer un réseau
Copier lien

Créez un réseau qui crée toutes les ressources AWS nécessaires à l’aide de modèles AWS CloudFormation. Cette commande d’aide est destinée à aider à créer et à configurer un VPC pour une utilisation avec ROSA avec HCP. Cette commande prend également en charge les clusters de sortie zéro.

Important

L’exécution de cette commande crée des ressources dans votre compte AWS.

Note

Dans le cas des configurations personnalisées ou avancées, il est fortement recommandé d’utiliser le CLI AWS directement à l’aide de la commande aws Cloudformation ou de créer un nouveau modèle personnalisé avec les configurations requises. Lorsque vous utilisez un modèle CloudFormation personnalisé avec le ROSA CLI, la version minimale requise est 1.2.47 ou ultérieure.

Syntaxe

rosa create network [flags]

$ rosa create network [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.32. Arguments
L’option	Définition
<template-nom>	Il vous permet d’utiliser un modèle personnalisé. Les modèles doivent être dans le dossier de modèles, structurés comme templates/<template-name>/cloudformation.yaml. En l’absence de nom de modèle, la commande utilise le modèle par défaut. Dans le cas des builds binaires, ce répertoire de modèles doit être référencé manuellement après son téléchargement.

Le modèle par défaut de CloudFormation

AWSTemplateFormatVersion: '2010-09-09'
Description: CloudFormation template to create a ROSA Quickstart default VPC.
  This CloudFormation template may not work with rosa CLI versions later than 1.2.47.
  Please ensure that you are using the compatible CLI version before deploying this template.

Parameters:
  AvailabilityZoneCount:
    Type: Number
    Description: "Number of Availability Zones to use"
    Default: 1
    MinValue: 1
    MaxValue: 3
  Region:
    Type: String
    Description: "AWS Region"
    Default: "us-west-2"
  Name:
    Type: String
    Description: "Name prefix for resources"
  VpcCidr:
    Type: String
    Description: CIDR block for the VPC
    Default: '10.0.0.0/16'

Conditions:
  HasAZ1: !Equals [!Ref AvailabilityZoneCount, 1]
  HasAZ2: !Equals [!Ref AvailabilityZoneCount, 2]
  HasAZ3: !Equals [!Ref AvailabilityZoneCount, 3]

  One:
    Fn::Or:
      - Condition: HasAZ1
      - Condition: HasAZ2
      - Condition: HasAZ3

  Two:
    Fn::Or:
      - Condition: HasAZ3
      - Condition: HasAZ2

Resources:
  VPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: !Ref VpcCidr
      EnableDnsSupport: true
      EnableDnsHostnames: true
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  S3VPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.s3"
      VpcEndpointType: Gateway
      RouteTableIds:
        - !Ref PublicRouteTable
        - !Ref PrivateRouteTable

  SubnetPublic1:
    Condition: One
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [0, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [0, !GetAZs '']
      MapPublicIpOnLaunch: true
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Public-Subnet-1"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/elb'
          Value: '1'

  SubnetPrivate1:
    Condition: One
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [1, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [0, !GetAZs '']
      MapPublicIpOnLaunch: false
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Subnet-1"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/internal-elb'
          Value: '1'

  SubnetPublic2:
    Condition: Two
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [2, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [1, !GetAZs '']
      MapPublicIpOnLaunch: true
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Public-Subnet-2"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/elb'
          Value: '1'

  SubnetPrivate2:
    Condition: Two
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [3, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [1, !GetAZs '']
      MapPublicIpOnLaunch: false
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Subnet-2"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/internal-elb'
          Value: '1'

  SubnetPublic3:
    Condition: HasAZ3
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [4, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [2, !GetAZs '']
      MapPublicIpOnLaunch: true
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Public-Subnet-3"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/elb'
          Value: '1'

  SubnetPrivate3:
    Condition: HasAZ3
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [5, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [2, !GetAZs '']
      MapPublicIpOnLaunch: false
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Subnet-3"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/internal-elb'
          Value: '1'

  InternetGateway:
    Type: AWS::EC2::InternetGateway
    Properties:
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  AttachGateway:
    Type: AWS::EC2::VPCGatewayAttachment
    Properties:
      VpcId: !Ref VPC
      InternetGatewayId: !Ref InternetGateway

  ElasticIP1:
    Type: AWS::EC2::EIP
    Properties:
      Domain: vpc
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  ElasticIP2:
    Type: AWS::EC2::EIP
    Properties:
      Domain: vpc
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  ElasticIP3:
    Condition: HasAZ3
    Type: AWS::EC2::EIP
    Properties:
      Domain: vpc
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  NATGateway1:
    Condition: One
    Type: 'AWS::EC2::NatGateway'
    Properties:
      AllocationId: !GetAtt ElasticIP1.AllocationId
      SubnetId: !Ref SubnetPublic1
      Tags:
        - Key: Name
          Value: !Sub "${Name}-NAT-1"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  NATGateway2:
    Condition: Two
    Type: 'AWS::EC2::NatGateway'
    Properties:
      AllocationId: !GetAtt ElasticIP2.AllocationId
      SubnetId: !Ref SubnetPublic2
      Tags:
        - Key: Name
          Value: !Sub "${Name}-NAT-2"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  NATGateway3:
    Condition: HasAZ3
    Type: 'AWS::EC2::NatGateway'
    Properties:
      AllocationId: !GetAtt ElasticIP3.AllocationId
      SubnetId: !Ref SubnetPublic3
      Tags:
        - Key: Name
          Value: !Sub "${Name}-NAT-3"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  PublicRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: !Ref VPC
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  PublicRoute:
    Type: AWS::EC2::Route
    DependsOn: AttachGateway
    Properties:
      RouteTableId: !Ref PublicRouteTable
      DestinationCidrBlock: 0.0.0.0/0
      GatewayId: !Ref InternetGateway

  PrivateRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: !Ref VPC
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Route-Table"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  PrivateRoute:
    Type: AWS::EC2::Route
    Properties:
      RouteTableId: !Ref PrivateRouteTable
      DestinationCidrBlock: 0.0.0.0/0
      NatGatewayId: !If
        - One
        - !Ref NATGateway1
        - !If
          - Two
          - !Ref NATGateway2
          - !If
            - HasAZ3
            - !Ref NATGateway3
            - !Ref "AWS::NoValue"

  PublicSubnetRouteTableAssociation1:
    Condition: One
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPublic1
      RouteTableId: !Ref PublicRouteTable

  PublicSubnetRouteTableAssociation2:
    Condition: Two
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPublic2
      RouteTableId: !Ref PublicRouteTable

  PublicSubnetRouteTableAssociation3:
    Condition: HasAZ3
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPublic3
      RouteTableId: !Ref PublicRouteTable

  PrivateSubnetRouteTableAssociation1:
    Condition: One
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPrivate1
      RouteTableId: !Ref PrivateRouteTable

  PrivateSubnetRouteTableAssociation2:
    Condition: Two
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPrivate2
      RouteTableId: !Ref PrivateRouteTable

  PrivateSubnetRouteTableAssociation3:
    Condition: HasAZ3
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPrivate3
      RouteTableId: !Ref PrivateRouteTable

  SecurityGroup:
    Type: AWS::EC2::SecurityGroup
    Properties:
      GroupDescription: "Authorize inbound VPC traffic"
      VpcId: !Ref VPC
      SecurityGroupIngress:
        - IpProtocol: -1
          FromPort: 0
          ToPort: 0
          CidrIp: "10.0.0.0/16"
      SecurityGroupEgress:
        - IpProtocol: -1
          FromPort: 0
          ToPort: 0
          CidrIp: 0.0.0.0/0
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'

  EC2VPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.ec2"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  KMSVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.kms"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  STSVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.sts"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  EcrApiVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.ecr.api"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  EcrDkrVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.ecr.dkr"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

Outputs:
  VPCId:
    Description: "VPC Id"
    Value: !Ref VPC
    Export:
      Name: !Sub "${Name}-VPCId"

  VPCEndpointId:
    Description: The ID of the VPC Endpoint
    Value: !Ref S3VPCEndpoint
    Export:
      Name: !Sub "${Name}-VPCEndpointId"

  PublicSubnets:
    Description: "Public Subnet Ids"
    Value: !Join [",", [!If [One, !Ref SubnetPublic1, !Ref "AWS::NoValue"], !If [Two, !Ref SubnetPublic2, !Ref "AWS::NoValue"], !If [HasAZ3, !Ref SubnetPublic3, !Ref "AWS::NoValue"]]]
    Export:
      Name: !Sub "${Name}-PublicSubnets"

  PrivateSubnets:
    Description: "Private Subnet Ids"
    Value: !Join [",", [!If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"], !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"], !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]]]
    Export:
      Name: !Sub "${Name}-PrivateSubnets"

  EIP1AllocationId:
    Description: Allocation ID for ElasticIP1
    Value: !GetAtt ElasticIP1.AllocationId
    Export:
      Name: !Sub "${Name}-EIP1-AllocationId"

  EIP2AllocationId:
    Description: Allocation ID for ElasticIP2
    Value: !GetAtt ElasticIP2.AllocationId
    Export:
      Name: !Sub "${Name}-EIP2-AllocationId"

  EIP3AllocationId:
    Condition: HasAZ3
    Description: Allocation ID for ElasticIP3
    Value: !GetAtt ElasticIP3.AllocationId
    Export:
      Name: !Sub "${Name}-EIP3-AllocationId"

  NatGatewayId:
    Description: The NAT Gateway IDs
    Value: !Join [",", [!If [One, !Ref NATGateway1, !Ref "AWS::NoValue"], !If [Two, !Ref NATGateway2, !Ref "AWS::NoValue"], !If [HasAZ3, !Ref NATGateway3, !Ref "AWS::NoValue"]]]
    Export:
      Name: !Sub "${Name}-NatGatewayId"

  InternetGatewayId:
    Description: The ID of the Internet Gateway
    Value: !Ref InternetGateway
    Export:
      Name: !Sub "${Name}-InternetGatewayId"

  PublicRouteTableId:
    Description: The ID of the public route table
    Value: !Ref PublicRouteTable
    Export:
      Name: !Sub "${Name}-PublicRouteTableId"

  PrivateRouteTableId:
    Description: The ID of the private route table
    Value: !Ref PrivateRouteTable
    Export:
      Name: !Sub "${Name}-PrivateRouteTableId"

  EC2VPCEndpointId:
    Description: The ID of the EC2 VPC Endpoint
    Value: !Ref EC2VPCEndpoint
    Export:
      Name: !Sub "${Name}-EC2VPCEndpointId"

  KMSVPCEndpointId:
    Description: The ID of the KMS VPC Endpoint
    Value: !Ref KMSVPCEndpoint
    Export:
      Name: !Sub "${Name}-KMSVPCEndpointId"

  STSVPCEndpointId:
    Description: The ID of the STS VPC Endpoint
    Value: !Ref STSVPCEndpoint
    Export:
      Name: !Sub "${Name}-STSVPCEndpointId"

  EcrApiVPCEndpointId:
    Description: The ID of the ECR API VPC Endpoint
    Value: !Ref EcrApiVPCEndpoint
    Export:
      Name: !Sub "${Name}-EcrApiVPCEndpointId"

  EcrDkrVPCEndpointId:
    Description: The ID of the ECR DKR VPC Endpoint
    Value: !Ref EcrDkrVPCEndpoint
    Export:
      Name: !Sub "${Name}-EcrDkrVPCEndpointId"

AWSTemplateFormatVersion: '2010-09-09'
Description: CloudFormation template to create a ROSA Quickstart default VPC.
  This CloudFormation template may not work with rosa CLI versions later than 1.2.47.
  Please ensure that you are using the compatible CLI version before deploying this template.

Parameters:
  AvailabilityZoneCount:
    Type: Number
    Description: "Number of Availability Zones to use"
    Default: 1
    MinValue: 1
    MaxValue: 3
  Region:
    Type: String
    Description: "AWS Region"
    Default: "us-west-2"
  Name:
    Type: String
    Description: "Name prefix for resources"
  VpcCidr:
    Type: String
    Description: CIDR block for the VPC
    Default: '10.0.0.0/16'

Conditions:
  HasAZ1: !Equals [!Ref AvailabilityZoneCount, 1]
  HasAZ2: !Equals [!Ref AvailabilityZoneCount, 2]
  HasAZ3: !Equals [!Ref AvailabilityZoneCount, 3]

  One:
    Fn::Or:
      - Condition: HasAZ1
      - Condition: HasAZ2
      - Condition: HasAZ3

  Two:
    Fn::Or:
      - Condition: HasAZ3
      - Condition: HasAZ2

Resources:
  VPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: !Ref VpcCidr
      EnableDnsSupport: true
      EnableDnsHostnames: true
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  S3VPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.s3"
      VpcEndpointType: Gateway
      RouteTableIds:
        - !Ref PublicRouteTable
        - !Ref PrivateRouteTable

  SubnetPublic1:
    Condition: One
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [0, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [0, !GetAZs '']
      MapPublicIpOnLaunch: true
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Public-Subnet-1"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/elb'
          Value: '1'

  SubnetPrivate1:
    Condition: One
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [1, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [0, !GetAZs '']
      MapPublicIpOnLaunch: false
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Subnet-1"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/internal-elb'
          Value: '1'

  SubnetPublic2:
    Condition: Two
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [2, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [1, !GetAZs '']
      MapPublicIpOnLaunch: true
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Public-Subnet-2"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/elb'
          Value: '1'

  SubnetPrivate2:
    Condition: Two
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [3, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [1, !GetAZs '']
      MapPublicIpOnLaunch: false
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Subnet-2"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/internal-elb'
          Value: '1'

  SubnetPublic3:
    Condition: HasAZ3
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [4, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [2, !GetAZs '']
      MapPublicIpOnLaunch: true
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Public-Subnet-3"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/elb'
          Value: '1'

  SubnetPrivate3:
    Condition: HasAZ3
    Type: AWS::EC2::Subnet
    Properties:
      VpcId: !Ref VPC
      CidrBlock: !Select [5, !Cidr [!Ref VpcCidr, 6, 8]]
      AvailabilityZone: !Select [2, !GetAZs '']
      MapPublicIpOnLaunch: false
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Subnet-3"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'kubernetes.io/role/internal-elb'
          Value: '1'

  InternetGateway:
    Type: AWS::EC2::InternetGateway
    Properties:
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  AttachGateway:
    Type: AWS::EC2::VPCGatewayAttachment
    Properties:
      VpcId: !Ref VPC
      InternetGatewayId: !Ref InternetGateway

  ElasticIP1:
    Type: AWS::EC2::EIP
    Properties:
      Domain: vpc
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  ElasticIP2:
    Type: AWS::EC2::EIP
    Properties:
      Domain: vpc
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  ElasticIP3:
    Condition: HasAZ3
    Type: AWS::EC2::EIP
    Properties:
      Domain: vpc
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  NATGateway1:
    Condition: One
    Type: 'AWS::EC2::NatGateway'
    Properties:
      AllocationId: !GetAtt ElasticIP1.AllocationId
      SubnetId: !Ref SubnetPublic1
      Tags:
        - Key: Name
          Value: !Sub "${Name}-NAT-1"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  NATGateway2:
    Condition: Two
    Type: 'AWS::EC2::NatGateway'
    Properties:
      AllocationId: !GetAtt ElasticIP2.AllocationId
      SubnetId: !Ref SubnetPublic2
      Tags:
        - Key: Name
          Value: !Sub "${Name}-NAT-2"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  NATGateway3:
    Condition: HasAZ3
    Type: 'AWS::EC2::NatGateway'
    Properties:
      AllocationId: !GetAtt ElasticIP3.AllocationId
      SubnetId: !Ref SubnetPublic3
      Tags:
        - Key: Name
          Value: !Sub "${Name}-NAT-3"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  PublicRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: !Ref VPC
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  PublicRoute:
    Type: AWS::EC2::Route
    DependsOn: AttachGateway
    Properties:
      RouteTableId: !Ref PublicRouteTable
      DestinationCidrBlock: 0.0.0.0/0
      GatewayId: !Ref InternetGateway

  PrivateRouteTable:
    Type: AWS::EC2::RouteTable
    Properties:
      VpcId: !Ref VPC
      Tags:
        - Key: Name
          Value: !Sub "${Name}-Private-Route-Table"
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'
        - Key: 'service'
          Value: 'ROSA'

  PrivateRoute:
    Type: AWS::EC2::Route
    Properties:
      RouteTableId: !Ref PrivateRouteTable
      DestinationCidrBlock: 0.0.0.0/0
      NatGatewayId: !If
        - One
        - !Ref NATGateway1
        - !If
          - Two
          - !Ref NATGateway2
          - !If
            - HasAZ3
            - !Ref NATGateway3
            - !Ref "AWS::NoValue"

  PublicSubnetRouteTableAssociation1:
    Condition: One
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPublic1
      RouteTableId: !Ref PublicRouteTable

  PublicSubnetRouteTableAssociation2:
    Condition: Two
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPublic2
      RouteTableId: !Ref PublicRouteTable

  PublicSubnetRouteTableAssociation3:
    Condition: HasAZ3
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPublic3
      RouteTableId: !Ref PublicRouteTable

  PrivateSubnetRouteTableAssociation1:
    Condition: One
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPrivate1
      RouteTableId: !Ref PrivateRouteTable

  PrivateSubnetRouteTableAssociation2:
    Condition: Two
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPrivate2
      RouteTableId: !Ref PrivateRouteTable

  PrivateSubnetRouteTableAssociation3:
    Condition: HasAZ3
    Type: AWS::EC2::SubnetRouteTableAssociation
    Properties:
      SubnetId: !Ref SubnetPrivate3
      RouteTableId: !Ref PrivateRouteTable

  SecurityGroup:
    Type: AWS::EC2::SecurityGroup
    Properties:
      GroupDescription: "Authorize inbound VPC traffic"
      VpcId: !Ref VPC
      SecurityGroupIngress:
        - IpProtocol: -1
          FromPort: 0
          ToPort: 0
          CidrIp: "10.0.0.0/16"
      SecurityGroupEgress:
        - IpProtocol: -1
          FromPort: 0
          ToPort: 0
          CidrIp: 0.0.0.0/0
      Tags:
        - Key: Name
          Value: !Ref Name
        - Key: 'service'
          Value: 'ROSA'
        - Key: 'rosa_managed_policies'
          Value: 'true'
        - Key: 'rosa_hcp_policies'
          Value: 'true'

  EC2VPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.ec2"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  KMSVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.kms"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  STSVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.sts"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  EcrApiVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.ecr.api"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

  EcrDkrVPCEndpoint:
    Type: AWS::EC2::VPCEndpoint
    Properties:
      VpcId: !Ref VPC
      ServiceName: !Sub "com.amazonaws.${Region}.ecr.dkr"
      PrivateDnsEnabled: true
      VpcEndpointType: Interface
      SubnetIds:
        - !If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"]
        - !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"]
        - !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]
      SecurityGroupIds:
        - !Ref SecurityGroup

Outputs:
  VPCId:
    Description: "VPC Id"
    Value: !Ref VPC
    Export:
      Name: !Sub "${Name}-VPCId"

  VPCEndpointId:
    Description: The ID of the VPC Endpoint
    Value: !Ref S3VPCEndpoint
    Export:
      Name: !Sub "${Name}-VPCEndpointId"

  PublicSubnets:
    Description: "Public Subnet Ids"
    Value: !Join [",", [!If [One, !Ref SubnetPublic1, !Ref "AWS::NoValue"], !If [Two, !Ref SubnetPublic2, !Ref "AWS::NoValue"], !If [HasAZ3, !Ref SubnetPublic3, !Ref "AWS::NoValue"]]]
    Export:
      Name: !Sub "${Name}-PublicSubnets"

  PrivateSubnets:
    Description: "Private Subnet Ids"
    Value: !Join [",", [!If [One, !Ref SubnetPrivate1, !Ref "AWS::NoValue"], !If [Two, !Ref SubnetPrivate2, !Ref "AWS::NoValue"], !If [HasAZ3, !Ref SubnetPrivate3, !Ref "AWS::NoValue"]]]
    Export:
      Name: !Sub "${Name}-PrivateSubnets"

  EIP1AllocationId:
    Description: Allocation ID for ElasticIP1
    Value: !GetAtt ElasticIP1.AllocationId
    Export:
      Name: !Sub "${Name}-EIP1-AllocationId"

  EIP2AllocationId:
    Description: Allocation ID for ElasticIP2
    Value: !GetAtt ElasticIP2.AllocationId
    Export:
      Name: !Sub "${Name}-EIP2-AllocationId"

  EIP3AllocationId:
    Condition: HasAZ3
    Description: Allocation ID for ElasticIP3
    Value: !GetAtt ElasticIP3.AllocationId
    Export:
      Name: !Sub "${Name}-EIP3-AllocationId"

  NatGatewayId:
    Description: The NAT Gateway IDs
    Value: !Join [",", [!If [One, !Ref NATGateway1, !Ref "AWS::NoValue"], !If [Two, !Ref NATGateway2, !Ref "AWS::NoValue"], !If [HasAZ3, !Ref NATGateway3, !Ref "AWS::NoValue"]]]
    Export:
      Name: !Sub "${Name}-NatGatewayId"

  InternetGatewayId:
    Description: The ID of the Internet Gateway
    Value: !Ref InternetGateway
    Export:
      Name: !Sub "${Name}-InternetGatewayId"

  PublicRouteTableId:
    Description: The ID of the public route table
    Value: !Ref PublicRouteTable
    Export:
      Name: !Sub "${Name}-PublicRouteTableId"

  PrivateRouteTableId:
    Description: The ID of the private route table
    Value: !Ref PrivateRouteTable
    Export:
      Name: !Sub "${Name}-PrivateRouteTableId"

  EC2VPCEndpointId:
    Description: The ID of the EC2 VPC Endpoint
    Value: !Ref EC2VPCEndpoint
    Export:
      Name: !Sub "${Name}-EC2VPCEndpointId"

  KMSVPCEndpointId:
    Description: The ID of the KMS VPC Endpoint
    Value: !Ref KMSVPCEndpoint
    Export:
      Name: !Sub "${Name}-KMSVPCEndpointId"

  STSVPCEndpointId:
    Description: The ID of the STS VPC Endpoint
    Value: !Ref STSVPCEndpoint
    Export:
      Name: !Sub "${Name}-STSVPCEndpointId"

  EcrApiVPCEndpointId:
    Description: The ID of the ECR API VPC Endpoint
    Value: !Ref EcrApiVPCEndpoint
    Export:
      Name: !Sub "${Name}-EcrApiVPCEndpointId"

  EcrDkrVPCEndpointId:
    Description: The ID of the ECR DKR VPC Endpoint
    Value: !Ref EcrDkrVPCEndpoint
    Export:
      Name: !Sub "${Name}-EcrDkrVPCEndpointId"

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.33. Drapeaux
L’option	Définition
--template-dir	Il vous permet de spécifier le chemin d’accès au répertoire de modèles. Remplace la variable d’environnement OCM_TEMPLATE_DIR. Requis si la commande n’est pas exécutée à l’intérieur du répertoire de modèles.
--nom de Paraam	Définissez le nom de votre réseau. Le paramètre requis lors de l’utilisation d’un fichier modèle personnalisé.
--région de Paraam	Définissez la région de votre réseau. Le paramètre requis lors de l’utilisation d’un fichier modèle personnalisé.
--Param <various>	Les paramètres disponibles dépendent du modèle. Dans le répertoire de modèles, utilisez --help pour trouver les paramètres disponibles.
--mode=manuel	Fournit des commandes AWS pour créer la pile réseau.

Exemple :

Créez un réseau de base avec des arguments et des drapeaux réguliers.

rosa create network rosa-quickstart-default-vpc --param Tags=key1=value1,key2=value2 --param Name=example-stack --param Region=us-west-2

$ rosa create network rosa-quickstart-default-vpc --param Tags=key1=value1,key2=value2 --param Name=example-stack --param Region=us-west-2

Copy to Clipboard

Toggle word wrap

8.2.3.11. créer ocm-role
Copier lien

Créez les ressources ocm-role requises pour votre cluster.

Syntaxe

rosa create ocm-role [flags]

$ rosa create ocm-role [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.34. Drapeaux
L’option	Définition
--admin	Activer les capacités d’administration pour le rôle.
--debug	Activer le mode débogage.
-I, --interactif	Activer le mode interactif.
-M, --mode chaîne	Comment effectuer l’opération. Les options valides sont: automatique : Les modifications de ressources seront automatiquement appliquées à l’aide du compte AWS actuel les commandes nécessaires pour modifier les ressources AWS seront sorties pour être exécutées manuellement
--chaîne de chemin	Le chemin ARN pour le rôle et les politiques de l’OCM.
--permissions-chaînes limitrophes	L’ARN de la politique utilisée pour définir la limite des autorisations pour le rôle OCM.
--chaîne de préfixe	Le préfixe défini par l’utilisateur pour toutes les ressources AWS générées. La valeur par défaut est ManagedOpenShift.
--fichier de chaîne	Utilisez un profil AWS spécifique à partir de votre fichier d’identification.
-y, --oui	Automatiquement répondre oui pour confirmer l’opération.

Afin d’obtenir de plus amples informations sur le rôle OCM créé avec la commande rosa, consultez le rôle de MAI à l’échelle du compte et la référence des politiques.

8.2.3.12. créer un rôle utilisateur
Copier lien

Créez les ressources de rôle utilisateur requises pour votre cluster.

Syntaxe

rosa create user-role [flags]

$ rosa create user-role [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.35. Drapeaux
L’option	Définition
--debug	Activer le mode débogage.
-I, --interactif	Activer le mode interactif.
-M, --mode chaîne	Comment effectuer l’opération. Les options valides sont: automatique : Les modifications de ressources seront automatiquement appliquées à l’aide du compte AWS actuel les commandes nécessaires pour modifier les ressources AWS seront sorties pour être exécutées manuellement
--chaîne de chemin	Le chemin ARN pour le rôle et les politiques de l’utilisateur.
--permissions-chaînes limitrophes	L’ARN de la stratégie utilisée pour définir la limite des autorisations pour le rôle de l’utilisateur.
--chaîne de préfixe	Le préfixe défini par l’utilisateur pour toutes les ressources AWS générées La valeur par défaut est ManagedOpenShift.
--fichier de chaîne	Utilisez un profil AWS spécifique à partir de votre fichier d’identification.
-y, --oui	Automatiquement répondre oui pour confirmer l’opération.

Afin d’obtenir de plus amples informations sur le rôle d’utilisateur créé avec la commande rosa, consultez Comprendre l’association de compte AWS.

8.2.5. Éditer des objets
Copier lien

Cette section décrit les commandes d’édition pour les clusters et les ressources.

8.2.5.1. groupe d’édition
Copier lien

Autorise les modifications à un cluster existant.

Syntaxe

rosa edit cluster --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa edit cluster --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.36. Arguments
L’option	Définition
--supplément-permis-principaux <arn>	Liste des ARN principaux autorisés supplémentaires à ajouter au service de point de terminaison VPC du plan de contrôle hébergé pour permettre l’acceptation automatique des demandes de connexion de point de terminaison VPC supplémentaires.
--cluster	Requis: Le nom ou l’ID (chaîne) du cluster à modifier.
--privé	Limite un point de terminaison principal de l’API à une connectivité directe et privée.
--enable-delete-protection=true	Active la fonction de protection de suppression.
--enable-delete-protection=faux	Désactive la fonction de protection de suppression.

Expand

Tableau 8.37. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Editez un cluster nommé mycluster pour le rendre privé.

rosa edit cluster --cluster=mycluster --private

$ rosa edit cluster --cluster=mycluster --private

Copy to Clipboard

Toggle word wrap

Éditer toutes les options de cluster de manière interactive sur un cluster nommé mycluster.

rosa edit cluster --cluster=mycluster --interactive

$ rosa edit cluster --cluster=mycluster --interactive

Copy to Clipboard

Toggle word wrap

8.2.5.2. Editer l’entrée
Copier lien

Edite le routeur d’application par défaut pour un cluster.

Note

En ce qui concerne l’édition de routeurs d’applications non par défaut, voir Ressources supplémentaires.

Syntaxe

rosa edit ingress --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa edit ingress --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.38. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster auquel l’entrée sera ajoutée.
--cluster-routes-hostname	Les composants routent le nom d’hôte pour OAuth, console et téléchargement.
--cluster-routes-tls-secret-ref	Les composants routent la référence secrète TLS pour OAuth, console et téléchargement.
--excluded-namespaces	Les espaces de noms exclus pour l’entrée. Le format est une valeur de liste séparée par virgule1, valeur2…. En l’absence de valeurs spécifiées, tous les espaces de noms seront exposés.
--label-match	Le label match (corde) pour ingress. Le format doit être une liste délimitée par virgule de paires key=valeur. En l’absence d’étiquette, tous les itinéraires sont exposés sur les deux routeurs.
--lb-type	Le type d’équilibreur de charge. Les options sont classiques, nlb.
--namespace-propriété-politique	La politique de propriété de l’espace de noms pour l’entrée. Les options sont Strict et InterNamespaceAllowed. La valeur par défaut est Strict.
--privé	Limite l’itinéraire de l’application à une connectivité directe et privée.
--route-séléctor	Le sélecteur d’itinéraire pour l’entrée. Le format est une liste séparée par virgule de key=valeur. En l’absence d’étiquette, tous les itinéraires seront exposés sur les deux routeurs. En ce qui concerne les entrées héritées, il s’agit d’étiquettes d’inclusion, sinon elles sont traitées comme des étiquettes d’exclusion.
--wildcard-policy	La politique de wildcard pour l’entrée. Les options sont WildcardsDisallowed et WildcardsAllowed. La valeur par défaut est WildcardsDisallowed.

Expand

Tableau 8.39. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Faites une entrée supplémentaire avec l’ID a1b2 comme connexion privée sur un cluster nommé mycluster.

rosa edit ingress --private --cluster=mycluster a1b2

$ rosa edit ingress --private --cluster=mycluster a1b2

Copy to Clipboard

Toggle word wrap

Actualisez les sélecteurs de routeur pour l’entrée supplémentaire avec l’ID a1b2 sur un cluster nommé mycluster.

rosa edit ingress --label-match=foo=bar --cluster=mycluster a1b2

$ rosa edit ingress --label-match=foo=bar --cluster=mycluster a1b2

Copy to Clipboard

Toggle word wrap

Actualisez l’entrée par défaut à l’aide des applications d’identification de sous-domaine sur un cluster nommé mycluster.

rosa edit ingress --private=false --cluster=mycluster apps

$ rosa edit ingress --private=false --cluster=mycluster apps

Copy to Clipboard

Toggle word wrap

Actualisez le type d’équilibreur de charge des applications2.

rosa edit ingress --lb-type=nlb --cluster=mycluster apps2

$ rosa edit ingress --lb-type=nlb --cluster=mycluster apps2

Copy to Clipboard

Toggle word wrap

8.2.5.3. Editer kubeletconfig
Copier lien

Éditer un objet KubeletConfig personnalisé dans un

Syntaxe

rosa edit kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]

$ rosa edit kubeletconfig --cluster=<cluster_name|cluster_id> --name=<kubeletconfig_name> --pod-pids-limit=<number> [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.40. Drapeaux
L’option	Définition
-C, --cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID du cluster pour lequel l’objet KubeletConfig sera édité.
-I, --interactif	Activer le mode interactif.
--pod-pids-limit <numéro>	C’est nécessaire. Le nombre maximal de PID pour chaque nœud dans le
--nom	Indique un nom pour l’objet KubeletConfig.
-h, --aide	Affiche l’aide pour cette commande.

Afin d’obtenir de plus amples informations sur la définition de la limite PID pour le cluster, consultez Configuring PID limites.

8.2.5.4. Editer la machinepool
Copier lien

Autorise les modifications dans le pool de machines dans un cluster.

Syntaxe

rosa edit machinepool --cluster=<cluster_name_or_id> <machinepool_name> [arguments]

$ rosa edit machinepool --cluster=<cluster_name_or_id> <machinepool_name> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.41. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster à modifier sur lequel le pool de machines supplémentaire sera édité.
--enable-autoscaling	Activer ou désactiver la mise à l’échelle automatique des nœuds de calcul. Afin d’activer l’autoscaling, utilisez cet argument avec les arguments --min-replicas et --max-replicas. Afin de désactiver l’autoscaling, utilisez --enable-autoscaling=false avec l’argument --replicas.
--étiquettes	Les étiquettes (chaîne) pour la piscine de machines. Le format doit être une liste délimitée par virgule de paires key=valeur. L’édition de cette valeur n’affecte que les nœuds nouvellement créés du pool de machines, qui sont créés en augmentant le nombre de nœuds, et n’affectent pas les nœuds existants. Cette liste écrase les modifications apportées aux étiquettes des nœuds sur une base continue.
--kubelet-configs <kubeletconfig_name>	Dans le cas de Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), les noms des objets KubeletConfig s’appliquent aux nœuds d’un pool de machines.
--max-replicas	Indique le nombre maximal de nœuds de calcul lors de l’activation de l’autoscaling.
--min-replicas	Indique le nombre minimum de nœuds de calcul lors de l’activation de l’autoscaling.
--Max-surge	Dans le cas de Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), le paramètre max-surge définit le nombre de nouveaux nœuds qui peuvent être fournis au-delà du nombre souhaité de répliques pour le pool de machines, comme configuré à l’aide du paramètre --replicas, ou tel que déterminé par l’autoscaler lorsque l’autoscaling est activé. Cela peut être un nombre absolu (par exemple, 2) ou un pourcentage de la taille du pool de la machine (par exemple, 20%), mais doit utiliser la même unité que le paramètre max-indisponible. La valeur par défaut est 1, ce qui signifie que le nombre maximum de nœuds dans le pool de machines lors d’une mise à niveau est de 1 plus le nombre de répliques souhaitée pour le pool de machines. Dans cette situation, un nœud excédentaire peut être fourni avant que les nœuds existants ne soient rendus indisponibles. Le nombre de nœuds qui peuvent être fournis simultanément lors d’une mise à niveau est max-surge plus max-indisponible.
--Max-indisponible	Dans le cas de Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), le paramètre max-indisponible définit le nombre de nœuds qui peuvent être rendus indisponibles dans un pool de machines lors d’une mise à niveau, avant que de nouveaux nœuds ne soient fournis. Cela peut être un nombre absolu (par exemple, 2) ou un pourcentage du nombre de répliques actuelles dans le pool de machines (par exemple, 20%), mais doit utiliser la même unité que le paramètre max-surge. La valeur par défaut est 0, ce qui signifie qu’aucun nœud obsolète n’est supprimé avant que de nouveaux nœuds ne soient provisionnés. La plage valide pour cette valeur est de 0 à la taille actuelle de la machine, ou de 0% à 100%. Le nombre total de nœuds qui peuvent être mis à niveau simultanément lors d’une mise à niveau est max-surge plus max-indisponible.
--node-drain-grace-période	Spécifie le délai de grâce de drain du nœud lors de la mise à niveau ou du remplacement du pool de machines. (Ceci est pour ROSA avec des clusters HCP seulement.)
--répliques	Lorsque l’autoscaling n’est pas configuré. Le nombre (integer) de machines pour ce pool de machines.
--tains	Des taintes pour la piscine de machines. Cette valeur de chaîne doit être formatée sous la forme d’une liste séparée par virgule de key=value:ScheduleType. L’édition de cette valeur n’affecte que les nœuds nouvellement créés du pool de machines, qui sont créés en augmentant le nombre de nœuds, et n’affectent pas les nœuds existants. Cette liste annule les modifications apportées aux taches de nœud sur une base continue.

Expand

Tableau 8.42. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemples

Définissez 4 répliques sur un pool de machines nommé mp1 sur un cluster nommé mycluster.

rosa edit machinepool --cluster=mycluster --replicas=4 mp1

$ rosa edit machinepool --cluster=mycluster --replicas=4 mp1

Copy to Clipboard

Toggle word wrap

Activer l’autoscaling sur un pool de machines nommé mp1 sur un cluster nommé mycluster.

rosa edit machinepool --cluster=mycluster --enable-autoscaling --min-replicas=3 --max-replicas=5 mp1

$ rosa edit machinepool --cluster=mycluster --enable-autoscaling --min-replicas=3 --max-replicas=5 mp1

Copy to Clipboard

Toggle word wrap

Désactivez l’autoscaling sur un pool de machines nommé mp1 sur un cluster nommé mycluster.

rosa edit machinepool --cluster=mycluster  --enable-autoscaling=false --replicas=3 mp1

$ rosa edit machinepool --cluster=mycluster  --enable-autoscaling=false --replicas=3 mp1

Copy to Clipboard

Toggle word wrap

Modifiez la plage d’autoscaling sur un pool de machines nommé mp1 sur un cluster nommé mycluster.

rosa edit machinepool --max-replicas=9 --cluster=mycluster mp1

$ rosa edit machinepool --max-replicas=9 --cluster=mycluster mp1

Copy to Clipboard

Toggle word wrap

Dans Red Hat OpenShift Service sur AWS (ROSA) avec des clusters de plans de contrôle hébergés (HCP), modifiez le pool de machines mp1 pour ajouter le comportement suivant lors des mises à niveau:

Autoriser jusqu’à 2 nœuds excédentaires à provisionner lors d’une mise à niveau.
Assurez-vous qu’au plus 3 nœuds ne sont pas disponibles lors d’une mise à niveau.

rosa edit machinepool --cluster=mycluster mp1 --max-surge=2 --max-unavailable=3

$ rosa edit machinepool --cluster=mycluster mp1 --max-surge=2 --max-unavailable=3

Copy to Clipboard

Toggle word wrap

Associez un objet KubeletConfig à un pool de machines haut débit existant sur un ROSA avec un cluster HCP.

rosa edit machinepool -c mycluster --kubelet-configs=set-high-pids high-pid-pool

$ rosa edit machinepool -c mycluster --kubelet-configs=set-high-pids high-pid-pool

Copy to Clipboard

Toggle word wrap

8.2.7. Effacer les objets
Copier lien

Cette section décrit les commandes de suppression pour les clusters et les ressources.

8.2.7.1. effacer l’administrateur
Copier lien

Supprime un administrateur de cluster à partir d’un cluster spécifié.

Syntaxe

rosa delete admin --cluster=<cluster_name> | <cluster_id>

$ rosa delete admin --cluster=<cluster_name> | <cluster_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.43. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster à ajouter au fournisseur d’identité (IDP).

Expand

Tableau 8.44. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Supprimez un administrateur de cluster d’un cluster nommé mycluster.

rosa delete admin --cluster=mycluster

$ rosa delete admin --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.7.2. supprimer le cluster
Copier lien

Supprime un cluster.

Syntaxe

rosa delete cluster --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa delete cluster --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.45. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster à supprimer.
----------	Surveille les journaux de désinstallation du cluster.
--meilleur effort	Saute les étapes de la chaîne de destruction des clusters qui sont connues pour causer l’échec du processus de suppression de cluster. Cette option devrait être utilisée avec soin et il est recommandé de vérifier manuellement votre compte AWS pour toutes les ressources qui pourraient être laissées après l’utilisation de --best-effort.

Expand

Tableau 8.46. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemples

Effacer un cluster nommé mycluster.

rosa delete cluster --cluster=mycluster

$ rosa delete cluster --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.7.3. supprimer externe-auth-fournisseur
Copier lien

Supprime un fournisseur d’authentification externe d’un cluster.

Syntaxe

rosa delete external-auth-provider <name_of_external_auth_provider> --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa delete external-auth-provider <name_of_external_auth_provider> --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.47. Arguments
L’option	Définition
--cluster	C’est nécessaire. Le nom ou la chaîne d’identification du cluster du fournisseur d’Auth externe sera supprimé.

Expand

Tableau 8.48. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique une chaîne de profil AWS à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemple :

Effacer un fournisseur d’identité nommé exauth-1 à partir d’un cluster nommé mycluster.

rosa delete external-auth-provider exauth-1 --cluster=mycluster

$ rosa delete external-auth-provider exauth-1 --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.7.4. effacer idp
Copier lien

Supprime un fournisseur d’identité spécifique (IDP) d’un cluster.

Syntaxe

rosa delete idp --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa delete idp --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.49. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster à partir duquel le PDI sera supprimé.

Expand

Tableau 8.50. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemple :

Effacer un fournisseur d’identité nommé github à partir d’un cluster nommé mycluster.

rosa delete idp github --cluster=mycluster

$ rosa delete idp github --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.7.5. effacer l’entrée
Copier lien

Supprime un routeur d’application non par défaut (ingress) d’un cluster.

Syntaxe

rosa delete ingress --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa delete ingress --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.51. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster à partir duquel l’entrée sera supprimée.

Expand

Tableau 8.52. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemples

Effacer une entrée avec l’ID a1b2 à partir d’un cluster nommé mycluster.

rosa delete ingress --cluster=mycluster a1b2

$ rosa delete ingress --cluster=mycluster a1b2

Copy to Clipboard

Toggle word wrap

Effacer une entrée secondaire avec le nom de sous-domaine apps2 à partir d’un cluster nommé mycluster.

rosa delete ingress --cluster=mycluster apps2

$ rosa delete ingress --cluster=mycluster apps2

Copy to Clipboard

Toggle word wrap

8.2.7.6. effacer kubeletconfig
Copier lien

Effacer un objet KubeletConfig personnalisé à partir d’un cluster.

Syntaxe

rosa delete kubeletconfig --cluster=<cluster_name|cluster_id> [flags]

$ rosa delete kubeletconfig --cluster=<cluster_name|cluster_id> [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.53. Drapeaux
L’option	Définition
-C, --cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID du cluster pour lequel vous souhaitez supprimer l’objet KubeletConfig.
-h, --aide	Affiche l’aide pour cette commande.
--nom	Indique un nom pour l’objet KubeletConfig.
-y, --oui	Automatiquement répond oui pour confirmer l’opération.

8.2.7.7. effacer la machinepool
Copier lien

Supprime un pool de machines d’un cluster.

Syntaxe

rosa delete machinepool --cluster=<cluster_name> | <cluster_id> <machine_pool_id>

$ rosa delete machinepool --cluster=<cluster_name> | <cluster_id> <machine_pool_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.54. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’identifiant (chaîne) du cluster dont le pool de machine sera supprimé.

Expand

Tableau 8.55. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--interactif	Active le mode interactif.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemple :

Effacer le pool de machines avec l’ID mp-1 à partir d’un cluster nommé mycluster.

rosa delete machinepool --cluster=mycluster mp-1

$ rosa delete machinepool --cluster=mycluster mp-1

Copy to Clipboard

Toggle word wrap

8.2.8. Installer et désinstaller des add-ons
Copier lien

Cette section décrit comment installer et désinstaller des modules de service gérés Red Hat sur un cluster.

8.2.8.1. installer addon
Copier lien

Installe un module de service géré sur un cluster.

Syntaxe

rosa install addon --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa install addon --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.56. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster où le module sera installé.

Expand

Tableau 8.57. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Utilise un profil AWS spécifique (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemple :

Ajoutez l’installation dbaas-operator add-on à un cluster nommé mycluster.

rosa install addon --cluster=mycluster dbaas-operator

$ rosa install addon --cluster=mycluster dbaas-operator

Copy to Clipboard

Toggle word wrap

8.2.8.2. désinstaller addon
Copier lien

Désinstaller un module de service géré à partir d’un cluster.

Syntaxe

rosa uninstall addon --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa uninstall addon --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.58. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster à partir duquel l’add-on sera désinstallé.

Expand

Tableau 8.59. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Utilise un profil AWS spécifique (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemple :

Enlevez l’installation dbaas-operator d’un cluster nommé mycluster.

rosa uninstall addon --cluster=mycluster dbaas-operator

$ rosa uninstall addon --cluster=mycluster dbaas-operator

Copy to Clipboard

Toggle word wrap

8.2.9. Liste et description des objets
Copier lien

Cette section décrit la liste et décrit les commandes pour les clusters et les ressources.

8.2.9.1. addon de liste
Copier lien

Énumérez les installations complémentaires de service gérées.

Syntaxe

rosa list addons --cluster=<cluster_name> | <cluster_id>

$ rosa list addons --cluster=<cluster_name> | <cluster_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.60. Arguments
L’option	Définition
--cluster	Requis: Le nom ou l’ID (chaîne) du cluster pour énumérer les add-ons pour.

Expand

Tableau 8.61. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

8.2.9.2. Liste des informations d’identification en verre cassé
Copier lien

Énumérez toutes les informations d’identification en verre cassé pour un cluster.

Syntaxe

rosa list break-glass-credential [arguments]

$ rosa list break-glass-credential [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.62. Arguments
L’option	Définition
--cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’identifiant du cluster auquel les informations d’identification en verre cassé ont été ajoutées.

Expand

Tableau 8.63. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Liste toutes les informations d’identification en verre cassé pour un cluster nommé mycluster.

rosa list break-glass-credential --cluster=mycluster

$ rosa list break-glass-credential --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.3. liste des clusters
Copier lien

Listez tous vos clusters.

Syntaxe

rosa list clusters [arguments]

$ rosa list clusters [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.64. Arguments
L’option	Définition
--compte	Le nombre (integer) de clusters à afficher. Défaut: 100

Expand

Tableau 8.65. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

8.2.9.4. liste externe-fournisseur auth
Copier lien

Liste des fournisseurs d’authentification externes pour un cluster.

Syntaxe

rosa list external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list external-auth-provider --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.66. Arguments
L’option	Définition
--cluster	Requis : Nom ou chaîne d’identification du cluster pour lequel le fournisseur d’authentification externe sera listé.

Expand

Tableau 8.67. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique une chaîne de profil AWS à partir de votre fichier d’identification.

Exemple :

Liste des fournisseurs d’authentification externes pour un cluster nommé mycluster.

rosa list external-auth-provider --cluster=mycluster

$ rosa list external-auth-provider --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.5. liste des idps
Copier lien

Énumérez tous les fournisseurs d’identité (IDP) pour un cluster.

Syntaxe

rosa list idps --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list idps --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.68. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster pour lequel les PDI seront listés.

Expand

Tableau 8.69. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Énumérez tous les fournisseurs d’identité (IDP) pour un cluster nommé mycluster.

rosa list idps --cluster=mycluster

$ rosa list idps --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.6. liste des entrées
Copier lien

Énumérez tous les points de terminaison API et ingress pour un cluster.

Syntaxe

rosa list ingresses --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list ingresses --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.70. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster pour lequel les PDI seront listés.

Expand

Tableau 8.71. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Énumérez tous les points de terminaison API et ingress pour un cluster nommé mycluster.

rosa list ingresses --cluster=mycluster

$ rosa list ingresses --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.7. liste des types d’instances
Copier lien

Énumérez tous les types d’instances disponibles pour une utilisation avec ROSA. La disponibilité est basée sur le quota AWS du compte.

Syntaxe

rosa list instance-types [arguments]

$ rosa list instance-types [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.72. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--sortie	Le format de sortie. Les formats autorisés sont json ou yaml.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Énumérez tous les types d’instances.

rosa list instance-types

$ rosa list instance-types

Copy to Clipboard

Toggle word wrap

8.2.9.8. liste des kubeletconfigs
Copier lien

Liste des objets KubeletConfig configurés sur un cluster.

Syntaxe

rosa list kubeletconfigs --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list kubeletconfigs --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.73. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’identifiant (chaîne) du cluster pour lequel les pools de machines seront listés.

Expand

Tableau 8.74. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.

Exemple :

Énumérez tous les objets KubeletConfig sur un cluster nommé mycluster.

rosa list kubeletconfigs --cluster=mycluster

$ rosa list kubeletconfigs --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.9. liste des pools de machines
Copier lien

Listez les pools de machines configurés sur un cluster.

Syntaxe

rosa list machinepools --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list machinepools --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.75. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’identifiant (chaîne) du cluster pour lequel les pools de machines seront listés.

Expand

Tableau 8.76. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Liste tous les pools de machines sur un cluster nommé mycluster.

rosa list machinepools --cluster=mycluster

$ rosa list machinepools --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.10. liste des régions
Copier lien

Énumérez toutes les régions disponibles pour le compte AWS actuel.

Syntaxe

rosa list regions [arguments]

$ rosa list regions [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.77. Arguments
L’option	Définition
--multi-az	Liste les régions qui fournissent un support pour plusieurs zones de disponibilité.

Expand

Tableau 8.78. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Liste de toutes les régions disponibles.

rosa list regions

$ rosa list regions

Copy to Clipboard

Toggle word wrap

8.2.9.11. liste des mises à jour
Copier lien

Énumérez toutes les mises à jour de la version cluster disponibles et programmées.

Syntaxe

rosa list upgrades --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list upgrades --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.79. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster pour lequel les mises à jour disponibles seront listées.

Expand

Tableau 8.80. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Liste toutes les mises à jour disponibles pour un cluster nommé mycluster.

rosa list upgrades --cluster=mycluster

$ rosa list upgrades --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.12. liste des utilisateurs
Copier lien

Énumérez l’administrateur du cluster et les utilisateurs d’administrateurs dédiés pour un cluster spécifié.

Syntaxe

rosa list users --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa list users --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.81. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster pour lequel les administrateurs de cluster seront listés.

Expand

Tableau 8.82. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Énumérez tous les administrateurs de cluster et les administrateurs dédiés pour un cluster nommé mycluster.

rosa list users --cluster=mycluster

$ rosa list users --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.13. liste des versions
Copier lien

Énumérez toutes les versions OpenShift disponibles pour la création d’un cluster.

Syntaxe

rosa list versions [arguments]

$ rosa list versions [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.83. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Énumérez toutes les versions OpenShift Container Platform.

rosa list versions

$ rosa list versions

Copy to Clipboard

Toggle word wrap

8.2.9.14. décrire l’administrateur
Copier lien

Afficher les détails d’un utilisateur cluster-admin spécifié et une commande pour se connecter au cluster.

Syntaxe

rosa describe admin --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa describe admin --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.84. Arguments
L’option	Définition
--cluster	Le nom ou l’ID (chaîne) du cluster auquel appartient le cluster-admin.

Expand

Tableau 8.85. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Décrivez l’utilisateur cluster-admin pour un cluster nommé mycluster.

rosa describe admin --cluster=mycluster

$ rosa describe admin --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.15. décrire addon
Copier lien

Afficher les détails d’un module complémentaire de service géré.

Syntaxe

rosa describe addon <addon_id> | <addon_name> [arguments]

$ rosa describe addon <addon_id> | <addon_name> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.86. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Décrivez un add-on nommé dbaas-operator.

rosa describe addon dbaas-operator

$ rosa describe addon dbaas-operator

Copy to Clipboard

Toggle word wrap

8.2.9.16. décrire les informations d’identification en verre cassé
Copier lien

Affiche les détails d’un identifiant de verre cassé pour un cluster spécifique.

Syntaxe

rosa describe break-glass-credential --id=<break_glass_credential_id> --cluster=<cluster_name>| <cluster_id> [arguments]

$ rosa describe break-glass-credential --id=<break_glass_credential_id> --cluster=<cluster_name>| <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.87. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster.
--ID	Requis: L’ID (chaîne) de l’identifiant de verre cassé.
--kubeconfig	Facultatif: Récupérez le kubeconfig à partir de l’identifiant de verre cassé.

Expand

Tableau 8.88. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

8.2.9.17. décrire le cluster
Copier lien

Affiche les détails d’un cluster.

Syntaxe

rosa describe cluster --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa describe cluster --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.89. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster.

Expand

Tableau 8.90. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--external-id <arn_string>	Identificateur unique optionnel qui pourrait être requis lorsque vous assumez un rôle dans un autre compte.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
--get-role-policy-bindings	Liste les politiques qui sont attachées aux rôles STS assignés au cluster.

Exemple :

Décrivez un cluster nommé mycluster.

rosa describe cluster --cluster=mycluster

$ rosa describe cluster --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.9.18. décrire kubeletconfig
Copier lien

Afficher les détails d’un objet KubeletConfig personnalisé.

Syntaxe

rosa describe kubeletconfig --cluster=<cluster_name|cluster_id> [flags]

$ rosa describe kubeletconfig --cluster=<cluster_name|cluster_id> [flags]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.91. Drapeaux
L’option	Définition
-C, --cluster <cluster_name>\|<cluster_id>	C’est nécessaire. Le nom ou l’ID du cluster pour lequel vous souhaitez afficher l’objet KubeletConfig.
-h, --aide	Affiche l’aide pour cette commande.
--nom	En option. Indique le nom de l’objet KubeletConfig à décrire.
-O, --sortie chaîne	-O, --sortie chaîne

8.2.9.19. décrire la machinepool
Copier lien

Décrit un pool de machines spécifique configuré sur un cluster.

Syntaxe

rosa describe machinepool --cluster=[<cluster_name>|<cluster_id>] --machinepool=<machinepool_name> [arguments]

$ rosa describe machinepool --cluster=[<cluster_name>|<cluster_id>] --machinepool=<machinepool_name> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.92. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster.
--piscine à machine	Requis: Le nom ou l’identifiant (chaîne) de la machinepool.

Expand

Tableau 8.93. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Décrivez un pool de machines nommé mymachinepool sur un cluster nommé mycluster.

rosa describe machinepool --cluster=mycluster --machinepool=mymachinepool

$ rosa describe machinepool --cluster=mycluster --machinepool=mymachinepool

Copy to Clipboard

Toggle word wrap

8.2.10. Abroger des objets
Copier lien

Cette section décrit les commandes de révocation pour les clusters et les ressources.

8.2.10.1. abroger-break-verre-crédential
Copier lien

Annule toutes les informations d’identification en verre cassées à partir d’un cluster de plan de contrôle hébergé spécifié avec authentification externe activée.

Syntaxe

rosa revoke break-glass-credential --cluster=<cluster_name> | <cluster_id>

$ rosa revoke break-glass-credential --cluster=<cluster_name> | <cluster_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.94. Arguments
L’option	Définition
--cluster	Requis: Le nom ou l’identifiant (chaîne) du cluster à partir duquel les informations d’identification en verre cassé seront supprimés.

Expand

Tableau 8.95. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.
-- oui	Automatiquement répond oui pour confirmer l’opération.

Exemple :

Annuler les informations d’identification en verre cassé d’un cluster nommé mycluster.

rosa revoke break-glass-credential --cluster=mycluster

$ rosa revoke break-glass-credential --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.11. Améliorez et supprimez la mise à niveau pour les objets
Copier lien

Cette section décrit l’utilisation de la commande de mise à niveau pour les objets.

8.2.11.1. cluster de mise à niveau
Copier lien

Planifiez une mise à niveau de cluster.

Syntaxe

rosa upgrade cluster --cluster=<cluster_name> | <cluster_id> [arguments]

$ rosa upgrade cluster --cluster=<cluster_name> | <cluster_id> [arguments]

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.96. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster pour lequel la mise à jour sera programmée.
--interactif	Active le mode interactif.
--version	La version (chaîne) d’OpenShift Container Platform vers laquelle le cluster sera mis à niveau.
--date d’horaire	La prochaine date (chaîne) où la mise à jour s’exécutera à l’heure spécifiée dans le Temps Universel Coordonné (UTC). Format: yyyy-mm-dd
--horaire-temps	La prochaine fois que la mise à jour s’exécutera à la date spécifiée dans le Temps Universel Coordonné (UTC). Format: HH:mm
--node-drain-grace-période [1]	Fixe un délai de grâce (chaînement) pour combien de temps les charges de travail protégées par le budget sont respectées pendant les mises à niveau. Après ce délai de grâce, toute charge de travail protégée par des budgets de perturbation de pod qui n’ont pas été vidés avec succès d’un nœud sera expulsée de force. Défaut: 1 heure
--avion de contrôle [2]	Améliore le plan de contrôle hébergé du cluster.

Clusters classiques uniquement
Le ROSA avec des clusters HCP uniquement

Expand

Tableau 8.97. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.

Exemples

De manière interactive, planifiez une mise à niveau sur un cluster nommé mycluster.

rosa upgrade cluster --cluster=mycluster --interactive

$ rosa upgrade cluster --cluster=mycluster --interactive

Copy to Clipboard

Toggle word wrap

Planifiez une mise à niveau de cluster dans l’heure sur un cluster nommé mycluster.

rosa upgrade cluster --cluster=mycluster --version 4.5.20

$ rosa upgrade cluster --cluster=mycluster --version 4.5.20

Copy to Clipboard

Toggle word wrap

8.2.11.2. supprimer la mise à niveau du cluster
Copier lien

Annuler une mise à niveau de cluster programmée.

Syntaxe

rosa delete upgrade --cluster=<cluster_name> | <cluster_id>

$ rosa delete upgrade --cluster=<cluster_name> | <cluster_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.98. Arguments
L’option	Définition
--cluster	Requis : Le nom ou l’ID (chaîne) du cluster pour lequel la mise à jour sera annulée.

Expand

Tableau 8.99. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
-- oui	Automatiquement répond oui pour confirmer l’opération.

8.2.11.3. améliorer la machinepool
Copier lien

Améliore un pool de machines spécifique configuré sur un ROSA avec le cluster HCP.

Note

La commande de mise à niveau pour les pools de machines s’applique uniquement à ROSA avec des clusters HCP.

Syntaxe

rosa upgrade machinepool --cluster=<cluster_name> <machinepool_name>

$ rosa upgrade machinepool --cluster=<cluster_name> <machinepool_name>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.100. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster.
--date d’horaire	La prochaine date (chaîne) où la mise à jour s’exécutera à l’heure spécifiée dans le Temps Universel Coordonné (UTC). Format: yyyy-mm-dd
--horaire-temps	La prochaine fois que la mise à jour s’exécutera à la date spécifiée dans le Temps Universel Coordonné (UTC). Format: HH:mm

Expand

Tableau 8.101. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Améliorez un pool de machines sur un cluster nommé mycluster.

rosa upgrade machinepool --cluster=mycluster

$ rosa upgrade machinepool --cluster=mycluster

Copy to Clipboard

Toggle word wrap

8.2.11.4. supprimer la mise à niveau de machinepool
Copier lien

Annuler une mise à niveau prévue de machinepool.

Syntaxe

rosa delete upgrade --cluster=<cluster_name> <machinepool_name>

$ rosa delete upgrade --cluster=<cluster_name> <machinepool_name>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.102. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster.

Expand

Tableau 8.103. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

8.2.11.5. améliorer les rôles
Copier lien

Améliore les rôles configurés sur un cluster.

Syntaxe

rosa upgrade roles --cluster=<cluster_id>

$ rosa upgrade roles --cluster=<cluster_id>

Copy to Clipboard

Toggle word wrap

Expand

Tableau 8.104. Arguments
L’option	Définition
--cluster	Requis : Nom ou ID (chaîne) du cluster.

Expand

Tableau 8.105. Arguments optionnels hérités des commandes parentes
L’option	Définition
--aider	Affiche l’aide pour cette commande.
--debug	Active le mode débogage.
--profil	Indique un profil AWS (corde) à partir de votre fichier d’identification.

Exemple :

Améliorez les rôles sur un cluster nommé mycluster.

rosa upgrade roles --cluster=mycluster

$ rosa upgrade roles --cluster=mycluster

Copy to Clipboard

Toggle word wrap

Retour au début

8.2. Gérer les objets avec le ROSA CLI

8.2.1. Commandes et arguments communsCopier lienLien copié sur presse-papiers!

8.2.1.1. débogageCopier lienLien copié sur presse-papiers!

8.2.1.2. à téléchargerCopier lienLien copié sur presse-papiers!

8.2.1.3. aideCopier lienLien copié sur presse-papiers!

8.2.1.4. interactifCopier lienLien copié sur presse-papiers!

8.2.1.5. le profilCopier lienLien copié sur presse-papiers!

8.2.1.6. la versionCopier lienLien copié sur presse-papiers!

8.2.2. Commandes parentesCopier lienLien copié sur presse-papiers!

8.2.2.1. créerCopier lienLien copié sur presse-papiers!

8.2.2.2. EditerCopier lienLien copié sur presse-papiers!

8.2.2.3. effacerCopier lienLien copié sur presse-papiers!

8.2.2.4. listeCopier lienLien copié sur presse-papiers!

8.2.2.5. décrireCopier lienLien copié sur presse-papiers!

8.2.3. Créer des objetsCopier lienLien copié sur presse-papiers!

8.2.3.1. créer des rôles de compteCopier lienLien copié sur presse-papiers!

8.2.3.2. créer un administrateurCopier lienLien copié sur presse-papiers!

8.2.3.3. créer des informations d’identification en verre casséCopier lienLien copié sur presse-papiers!

8.2.3.4. créer un clusterCopier lienLien copié sur presse-papiers!

8.2.3.5. créer un fournisseur externeCopier lienLien copié sur presse-papiers!

8.2.3.6. créer idpCopier lienLien copié sur presse-papiers!

8.2.3.7. créer une entréeCopier lienLien copié sur presse-papiers!

8.2.3.8. créer kubeletconfigCopier lienLien copié sur presse-papiers!

8.2.3.9. créer machinepoolCopier lienLien copié sur presse-papiers!

8.2.3.10. créer un réseauCopier lienLien copié sur presse-papiers!

8.2.3.11. créer ocm-roleCopier lienLien copié sur presse-papiers!

8.2.3.12. créer un rôle utilisateurCopier lienLien copié sur presse-papiers!

8.2.5. Éditer des objetsCopier lienLien copié sur presse-papiers!

8.2.5.1. groupe d’éditionCopier lienLien copié sur presse-papiers!

8.2.5.2. Editer l’entréeCopier lienLien copié sur presse-papiers!

8.2.5.3. Editer kubeletconfigCopier lienLien copié sur presse-papiers!

8.2.5.4. Editer la machinepoolCopier lienLien copié sur presse-papiers!

8.2.7. Effacer les objetsCopier lienLien copié sur presse-papiers!

8.2.7.1. effacer l’administrateurCopier lienLien copié sur presse-papiers!

8.2.7.2. supprimer le clusterCopier lienLien copié sur presse-papiers!

8.2.7.3. supprimer externe-auth-fournisseurCopier lienLien copié sur presse-papiers!

8.2.7.4. effacer idpCopier lienLien copié sur presse-papiers!

8.2.7.5. effacer l’entréeCopier lienLien copié sur presse-papiers!

8.2.7.6. effacer kubeletconfigCopier lienLien copié sur presse-papiers!

8.2.7.7. effacer la machinepoolCopier lienLien copié sur presse-papiers!

8.2.8. Installer et désinstaller des add-onsCopier lienLien copié sur presse-papiers!

8.2.8.1. installer addonCopier lienLien copié sur presse-papiers!

8.2.8.2. désinstaller addonCopier lienLien copié sur presse-papiers!

8.2.9. Liste et description des objetsCopier lienLien copié sur presse-papiers!

8.2.9.1. addon de listeCopier lienLien copié sur presse-papiers!

8.2.9.2. Liste des informations d’identification en verre casséCopier lienLien copié sur presse-papiers!

8.2.9.3. liste des clustersCopier lienLien copié sur presse-papiers!

8.2.9.4. liste externe-fournisseur authCopier lienLien copié sur presse-papiers!

8.2.9.5. liste des idpsCopier lienLien copié sur presse-papiers!

8.2.9.6. liste des entréesCopier lienLien copié sur presse-papiers!

8.2.9.7. liste des types d’instancesCopier lienLien copié sur presse-papiers!

8.2.9.8. liste des kubeletconfigsCopier lienLien copié sur presse-papiers!

8.2.9.9. liste des pools de machinesCopier lienLien copié sur presse-papiers!

8.2.9.10. liste des régionsCopier lienLien copié sur presse-papiers!

8.2.9.11. liste des mises à jourCopier lienLien copié sur presse-papiers!

8.2.9.12. liste des utilisateursCopier lienLien copié sur presse-papiers!

8.2.9.13. liste des versionsCopier lienLien copié sur presse-papiers!

8.2.9.14. décrire l’administrateurCopier lienLien copié sur presse-papiers!

8.2.9.15. décrire addonCopier lienLien copié sur presse-papiers!

8.2.9.16. décrire les informations d’identification en verre casséCopier lienLien copié sur presse-papiers!

8.2.9.17. décrire le clusterCopier lienLien copié sur presse-papiers!

8.2.9.18. décrire kubeletconfigCopier lienLien copié sur presse-papiers!

8.2.9.19. décrire la machinepoolCopier lienLien copié sur presse-papiers!

8.2.10. Abroger des objetsCopier lienLien copié sur presse-papiers!

8.2.10.1. abroger-break-verre-crédentialCopier lienLien copié sur presse-papiers!

8.2.11. Améliorez et supprimez la mise à niveau pour les objetsCopier lienLien copié sur presse-papiers!

8.2.11.1. cluster de mise à niveauCopier lienLien copié sur presse-papiers!

8.2.11.2. supprimer la mise à niveau du clusterCopier lienLien copié sur presse-papiers!

8.2.11.3. améliorer la machinepoolCopier lienLien copié sur presse-papiers!

8.2.11.4. supprimer la mise à niveau de machinepoolCopier lienLien copié sur presse-papiers!

8.2.11.5. améliorer les rôlesCopier lienLien copié sur presse-papiers!

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Rendre l’open source plus inclusif

À propos de Red Hat

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

8.2.1. Commandes et arguments communs
Copier lien

8.2.1.1. débogage
Copier lien

8.2.1.2. à télécharger
Copier lien

8.2.1.3. aide
Copier lien

8.2.1.4. interactif
Copier lien

8.2.1.5. le profil
Copier lien

8.2.1.6. la version
Copier lien

8.2.2. Commandes parentes
Copier lien

8.2.2.1. créer
Copier lien

8.2.2.2. Editer
Copier lien

8.2.2.3. effacer
Copier lien

8.2.2.4. liste
Copier lien

8.2.2.5. décrire
Copier lien

8.2.3. Créer des objets
Copier lien

8.2.3.1. créer des rôles de compte
Copier lien

8.2.3.2. créer un administrateur
Copier lien

8.2.3.3. créer des informations d’identification en verre cassé
Copier lien

8.2.3.4. créer un cluster
Copier lien

8.2.3.5. créer un fournisseur externe
Copier lien

8.2.3.6. créer idp
Copier lien

8.2.3.7. créer une entrée
Copier lien

8.2.3.8. créer kubeletconfig
Copier lien

8.2.3.9. créer machinepool
Copier lien

8.2.3.10. créer un réseau
Copier lien

8.2.3.11. créer ocm-role
Copier lien

8.2.3.12. créer un rôle utilisateur
Copier lien

8.2.5. Éditer des objets
Copier lien

8.2.5.1. groupe d’édition
Copier lien

8.2.5.2. Editer l’entrée
Copier lien

8.2.5.3. Editer kubeletconfig
Copier lien

8.2.5.4. Editer la machinepool
Copier lien

8.2.7. Effacer les objets
Copier lien

8.2.7.1. effacer l’administrateur
Copier lien

8.2.7.2. supprimer le cluster
Copier lien

8.2.7.3. supprimer externe-auth-fournisseur
Copier lien

8.2.7.4. effacer idp
Copier lien

8.2.7.5. effacer l’entrée
Copier lien

8.2.7.6. effacer kubeletconfig
Copier lien

8.2.7.7. effacer la machinepool
Copier lien

8.2.8. Installer et désinstaller des add-ons
Copier lien

8.2.8.1. installer addon
Copier lien

8.2.8.2. désinstaller addon
Copier lien

8.2.9. Liste et description des objets
Copier lien

8.2.9.1. addon de liste
Copier lien

8.2.9.2. Liste des informations d’identification en verre cassé
Copier lien

8.2.9.3. liste des clusters
Copier lien

8.2.9.4. liste externe-fournisseur auth
Copier lien

8.2.9.5. liste des idps
Copier lien

8.2.9.6. liste des entrées
Copier lien

8.2.9.7. liste des types d’instances
Copier lien

8.2.9.8. liste des kubeletconfigs
Copier lien

8.2.9.9. liste des pools de machines
Copier lien

8.2.9.10. liste des régions
Copier lien

8.2.9.11. liste des mises à jour
Copier lien

8.2.9.12. liste des utilisateurs
Copier lien

8.2.9.13. liste des versions
Copier lien

8.2.9.14. décrire l’administrateur
Copier lien

8.2.9.15. décrire addon
Copier lien

8.2.9.16. décrire les informations d’identification en verre cassé
Copier lien

8.2.9.17. décrire le cluster
Copier lien

8.2.9.18. décrire kubeletconfig
Copier lien

8.2.9.19. décrire la machinepool
Copier lien

8.2.10. Abroger des objets
Copier lien

8.2.10.1. abroger-break-verre-crédential
Copier lien

8.2.11. Améliorez et supprimez la mise à niveau pour les objets
Copier lien

8.2.11.1. cluster de mise à niveau
Copier lien

8.2.11.2. supprimer la mise à niveau du cluster
Copier lien

8.2.11.3. améliorer la machinepool
Copier lien

8.2.11.4. supprimer la mise à niveau de machinepool
Copier lien

8.2.11.5. améliorer les rôles
Copier lien