Configuration de votre premier cluster classique dans l'interface de ligne de commande

Infrastructure classique

Dans ce tutoriel, vous déployez un cluster Red Hat OpenShift on IBM Cloud sur l'infrastructure Classic à l'aide de l'interface de ligne de commande.

Public ciblé

Ce tutoriel est destiné aux administrateurs de clusters qui souhaitent apprendre à créer un cluster Red Hat OpenShift on IBM Cloud pour la première fois en utilisant le CLI.

Objectifs

Dans ce tutoriel, vous effectuez les tâches suivantes.

Créez un cluster à Washington, DC avec 2 noeuds worker dotés de 4 coeurs et de 16 Go de mémoire.
Ouvrez la console Web d'Red Hat OpenShift.
Déployez un exemple d'application.
Exposez l'application sur une route afin que les utilisateurs externes puissent accéder au service.

Ce que vous obtiendrez

Dans ce tutoriel, vous créez les ressources suivantes à l'aide de l'interface de ligne de commande. Il existe des étapes facultatives pour supprimer ces ressources si vous ne souhaitez pas les conserver après avoir suivi le tutoriel.

Un cluster classique avec 2 noeuds worker
Une application Hello World simple déployée sur votre cluster
Une route pour exposer votre application

Présentation des ressources de cluster

Consultez le diagramme suivant pour une présentation des ressources de cluster communes.

Prérequis

Vérifiez vos droits. Si vous êtes le propriétaire du compte, vous disposez déjà des autorisations nécessaires pour créer un cluster et vous pouvez passer à l'étape suivante. Si vous n'êtes pas le propriétaire du compte, demandez au propriétaire du compte de configurer une clé d'API et de vous affecter les droits requis dans IBM Cloud IAM.
Installez les outils d'interface de ligne de commande IBM Cloud.

Création d'un cluster Red Hat OpenShift on IBM Cloud

Connectez-vous à votre compte et à votre groupe de ressources. Si vous disposez d'un compte fédéré, incluez l'option --sso.
```
ibmcloud login [-g RESOURCE GROUP] [--sso]
```

Exécutez la commande suivante pour créer un cluster de version 4.17 à Washington, DC, avec 2 nœuds de travail dotés de 4 cœurs et de 16 Go de mémoire.

ibmcloud oc cluster create classic --name my-tutorial-cluster --location wdc04 --version 4.17_openshift --flavor b3c.4x16  --workers 2 --public-service-endpoint

Votre opération de création de cluster peut durer un certain temps. Une fois que l'état du cluster affiche Normal, le réseau de cluster et les composants d'entrée prennent environ 10 minutes pour déployer et mettre à jour le domaine de clusters que vous utilisez pour la console Web Red Hat OpenShift et d'autres routes.
Répertoriez les détails de votre cluster. Examinez l'état du cluster, vérifiez le sous-domaine Ingress et notez l'URL du maître.
```
ibmcloud oc cluster get --cluster <cluster_name_or_ID>
```
Téléchargez et ajoutez le fichier de configuration kubeconfig pour votre cluster.
```
ibmcloud oc cluster config --cluster <cluster_name_or_ID>
```
Dans votre navigateur, accédez à l'adresse de votre URL du maître et ajoutez /console. Par exemple, https://c0.containers.cloud.ibm.com:23652/console.
Cliquez sur votre profil IAM#user.name@email.com > Copy Login Command. Affichez et copiez la commande de jeton oc login sur votre ligne de commande pour vous authentifier via l'interface CLI.
Vérifiez que les commandes oc s'exécutent correctement avec votre cluster en vérifiant la version.
```
oc version
```
Exemple de sortie
```
Client Version: v4.17.0
Kubernetes Version: v1.32.3.2
```
Si vous ne pouvez pas effectuer les opérations qui nécessitent des autorisations d'administrateur, telles que la liste de tous les nœuds worker ou pods d'un cluster, téléchargez les certificats TLS et les fichiers d'autorisation pour l'administrateur du cluster en exécutant la commande ibmcloud oc cluster config --cluster <cluster_name_or_ID> --admin.

Navigation dans la console Red Hat OpenShift

Dans la console, sélectionnez votre cluster Red Hat OpenShift, puis cliquez sur OpenShift web console.
Pour utiliser votre cluster dans l'interface de ligne de commande, cliquez sur votre profil IAM#user.name@email.com > Copy Login Command. Affichez et copiez la commande de jeton oc login sur votre ligne de commande pour vous authentifier via l'interface CLI.

Déploiement d'une application dans votre cluster

Créez un projet pour votre application Hello World.
```
oc new-project hello-world
```
Générez le modèle d'application à partir du code source à l'aide de la commande oc new-app.
```
oc new-app --name hello-world https://github.com/IBM/container-service-getting-started-wt --context-dir="Lab 1"
```
Un message d'avertissement peut s'afficher dans la sortie, mais il n'affecte pas cet exemple.
Répertoriez les services hello-world et notez le nom de service. Votre application écoute le trafic sur ces adresses IP de cluster interne, sauf si vous créez une route pour le service afin que le contrôleur Ingress puisse acheminer des demandes de trafic externes vers l'application.
```
oc get svc -n hello-world
```
Exemple de sortie
```
NAME          TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
hello-world   ClusterIP   172.21.xxx.xxx   <none>       8080/TCP   31m
```

Répertoriez les pods et assurez-vous que le statut des pods hello-world est En cours d'exécution et que les pods build et deploy sont Terminé

oc get pods -n hello-world

Exemple de sortie

NAME                  READY     STATUS             RESTARTS   AGE
hello-world-1-9cv7d   1/1       Running            0          30m
hello-world-1-build   0/1       Completed          0          31m
hello-world-1-deploy  0/1       Completed          0          31m

Configurez un chemin afin de pouvoir accéder publiquement au service hello world.
```
oc create route edge --service=hello-world -n hello-world
```

Récupérez l'adresse de nom d'hôte de route dans la colonne HOST/PORT.

oc get route -n hello-world

Exemple de sortie

NAME          HOST/PORT                         PATH                                        SERVICES      PORT       TERMINATION   WILDCARD
hello-world   hello-world-hello.world.CLUSTER-NAME-RANDOM-ID.REGION.containers.appdomain.cloud    hello-world   8080-tcp   edge/Allow    None

Accédez à votre application. Prenez soin d'ajouter https:// à votre nom d'hôte de route. L'affichage du service exposé peut prendre une minute.

curl https://hello-world-hello-world.CLUSTER-NAME-RANDOM-ID.REGION.containers.appdomain.cloud

Exemple de sortie

Hello world from hello-world-9cv7d! Your app is up and running in a cluster!

Nettoyer les ressources du didacticiel

Répertoriez les ressources du projet hello-world.

oc get all -l app=hello-world -o name -n hello-world

Exemple de sortie

pod/hello-world-1-dh2ff
replicationcontroller/hello-world-1
service/hello-world
deploymentconfig.apps.openshift.io/hello-world
buildconfig.build.openshift.io/hello-world
build.build.openshift.io/hello-world-1
imagestream.image.openshift.io/hello-world
imagestream.image.openshift.io/node
route.route.openshift.io/hello-world

Supprimez les ressources.

oc delete all -l app=hello-world -n hello-world

Étape suivante ?

Pour plus d'informations sur l'utilisation de vos applications, consultez la documentation sur les activités des développeurs sur le site Red Hat OpenShift.

Installez deux modules complémentaires populaires pour cluster d' Red Hat OpenShift on IBM Cloud s : IBM Cloud Logs et IBM Cloud Monitoring.