Applications dans le domaine de la construction

Procédure

1. Naviguez jusqu'à Home → Projects.
2. Cliquez sur Create Project.
3. Entrez les détails de votre projet.
4. Cliquez sur Create.

1. Cliquez sur le menu déroulant Project pour obtenir une liste de tous les projets disponibles. Sélectionnez Create Project.

   Figure 2.1. Créer un projet

   

   View larger image

   
2. Dans la boîte de dialogue Create Project, saisissez un nom unique, tel que myproject, dans le champ Name.
3. Optionnel : Ajoutez les détails Display Name et Description pour le projet.
4. Cliquez sur Create.
5. Utilisez le panneau de navigation de gauche pour accéder à la vue Project et voir le tableau de bord de votre projet.

6. En option :

   • Utilisez le menu déroulant Project en haut de l'écran et sélectionnez all projects pour lister tous les projets de votre cluster.
   • Utilisez l'onglet Details pour voir les détails du projet.
   • Si vous disposez des autorisations adéquates pour un projet, vous pouvez utiliser l'onglet Project Access pour accorder ou révoquer les privilèges administrator, edit et view pour le projet.

Procédure

1. Naviguez jusqu'à Home → Projects.

2. Sélectionnez un projet à visualiser.

   Sur cette page, cliquez sur Workloads pour voir les charges de travail du projet.

Procédure

1. Pour afficher une liste de projets, exécutez :

   $ oc get projects

   Copy to Clipboard Toggle word wrap

2. Vous pouvez passer du projet actuel à un autre projet pour les opérations de l'interface de programmation. Le projet spécifié est alors utilisé dans toutes les opérations ultérieures qui manipulent le contenu d'un projet :

   oc project <nom_du_projet>

   Copy to Clipboard Toggle word wrap

1. Dans la perspective Developer, accédez à la vue Project.
2. Dans la page Project, sélectionnez l'onglet Project Access.

3. Cliquez sur Add Access pour ajouter une nouvelle ligne d'autorisations à celles qui sont définies par défaut.

   Figure 2.2. Autorisations de projet

   

   View larger image

   
4. Saisissez le nom de l'utilisateur, cliquez sur la liste déroulante Select a role et sélectionnez un rôle approprié.
5. Cliquez sur Save pour ajouter les nouvelles autorisations.

1. Dans la vue Search, utilisez la liste déroulante Resources pour rechercher Console.

2. Parmi les options disponibles, sélectionnez l'option Console operator.openshift.io/v1.

   Figure 2.3. Recherche d'une ressource de la console

   

   View larger image

   
3. Sélectionnez cluster dans la liste Name.
4. Naviguez vers l'onglet YAML pour visualiser et modifier le code YAML.

5. Dans le code YAML sous spec, ajoutez ou modifiez la liste de availableClusterRoles et enregistrez vos modifications :

   spec:
     customization:
       projectAccess:
         availableClusterRoles:
         - admin
         - edit
         - view

   Copy to Clipboard Toggle word wrap

Procédure

1. Sélectionnez Developer dans le sélecteur de contexte en haut du menu de navigation de la console web.
2. Cliquez sur Add
3. En haut de la page, sélectionnez le nom du projet que vous souhaitez ajouter.
4. Cliquez sur une méthode à ajouter à votre projet, puis suivez le flux de travail.

Procédure

1. Naviguez jusqu'à Home → Projects.
2. Sélectionnez un projet pour connaître son statut.

Procédure

1. Exécutez :

   $ oc status

   Copy to Clipboard Toggle word wrap

   Cette commande fournit une vue d'ensemble du projet en cours, avec ses composants et leurs relations.

Procédure

1. Naviguez jusqu'à Home → Projects.
2. Localisez le projet que vous souhaitez supprimer dans la liste des projets.
3. À l'extrême droite de la liste des projets, sélectionnez Delete Project dans le menu Options .
4. Lorsque le volet Delete Project s'ouvre, saisissez le nom du projet que vous souhaitez supprimer dans le champ.
5. Cliquez sur Delete.

Procédure

1. Exécutez :

   oc delete project <project_name> $ oc delete project <project_name>

   Copy to Clipboard Toggle word wrap

Procédure

1. Connectez-vous en tant qu'utilisateur disposant des privilèges cluster-admin.

2. Générer le modèle de projet par défaut :

   oc adm create-bootstrap-project-template -o yaml > template.yaml

   Copy to Clipboard Toggle word wrap
3. Utilisez un éditeur de texte pour modifier le fichier template.yaml généré en ajoutant des objets ou en modifiant des objets existants.

4. Le modèle de projet doit être créé dans l'espace de noms openshift-config. Chargez votre modèle modifié :

   $ oc create -f template.yaml -n openshift-config

   Copy to Clipboard Toggle word wrap

5. Modifiez la ressource de configuration du projet à l'aide de la console Web ou de la CLI.

   • En utilisant la console web :

     1. Naviguez jusqu'à la page Administration → Cluster Settings.
     2. Cliquez sur Configuration pour afficher toutes les ressources de configuration.
     3. Trouvez l'entrée pour Project et cliquez sur Edit YAML.

   • Utilisation de la CLI :

     1. Modifier la ressource project.config.openshift.io/cluster:

        $ oc edit project.config.openshift.io/cluster

        Copy to Clipboard Toggle word wrap

6. Mettez à jour la section spec pour inclure les paramètres projectRequestTemplate et name, et définissez le nom de votre modèle de projet téléchargé. Le nom par défaut est project-request.

   Ressource de configuration de projet avec modèle de projet personnalisé

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestTemplate:
       name: <template_name>

   Copy to Clipboard Toggle word wrap

7. Après avoir enregistré vos modifications, créez un nouveau projet pour vérifier que vos modifications ont bien été appliquées.

Procédure

1. Connectez-vous en tant qu'utilisateur disposant des privilèges cluster-admin.

2. Affichez l'utilisation de la liaison de rôle du cluster self-provisioners en exécutant la commande suivante :

   $ oc describe clusterrolebinding.rbac self-provisioners

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   Name:		self-provisioners
   Labels:		<none>
   Annotations:	rbac.authorization.kubernetes.io/autoupdate=true
   Role:
     Kind:	ClusterRole
     Name:	self-provisioner
   Subjects:
     Kind	Name				Namespace
     ----	----				---------
     Group	system:authenticated:oauth

   Copy to Clipboard Toggle word wrap

   Passez en revue les sujets de la section self-provisioners.

3. Supprimez le rôle de cluster self-provisioner du groupe system:authenticated:oauth.

   • Si la liaison des rôles du cluster self-provisioners lie uniquement le rôle self-provisioner au groupe system:authenticated:oauth, exécutez la commande suivante :

     $ oc patch clusterrolebinding.rbac self-provisioners -p '{"subjects": null}'

     Copy to Clipboard Toggle word wrap

   • Si la liaison du rôle de cluster self-provisioners lie le rôle self-provisioner à plus d'utilisateurs, de groupes ou de comptes de service que le groupe system:authenticated:oauth, exécutez la commande suivante :

     $ oc adm policy \
         remove-cluster-role-from-group self-provisioner \
         system:authenticated:oauth

     Copy to Clipboard Toggle word wrap

4. Modifiez le lien du rôle de cluster self-provisioners pour empêcher les mises à jour automatiques du rôle. Les mises à jour automatiques réinitialisent les rôles de cluster à l'état par défaut.

   • Pour mettre à jour l'attribution des rôles à l'aide de l'interface de ligne de commande :

     1. Exécutez la commande suivante :

        $ oc edit clusterrolebinding.rbac self-provisioners

        Copy to Clipboard Toggle word wrap

     2. Dans la définition de rôle affichée, définissez la valeur du paramètre rbac.authorization.kubernetes.io/autoupdate sur false, comme indiqué dans l'exemple suivant :

        apiVersion: authorization.openshift.io/v1
        kind: ClusterRoleBinding
        metadata:
          annotations:
            rbac.authorization.kubernetes.io/autoupdate: "false"
          ...

        Copy to Clipboard Toggle word wrap

   • Pour mettre à jour l'attribution des rôles à l'aide d'une seule commande :

     $ oc patch clusterrolebinding.rbac self-provisioners -p '{ "metadata": { "annotations": { "rbac.authorization.kubernetes.io/autoupdate": "false" } } }'

     Copy to Clipboard Toggle word wrap

5. Connectez-vous en tant qu'utilisateur authentifié et vérifiez qu'il n'est plus possible d'auto-provisionner un projet :

   $ oc new-project test

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   Error from server (Forbidden): You may not request a new project via this API.

   Copy to Clipboard Toggle word wrap

   Pensez à personnaliser ce message de demande de projet pour fournir des instructions plus utiles et spécifiques à votre organisation.

Procédure

1. Modifiez la ressource de configuration du projet à l'aide de la console Web ou de la CLI.

   • En utilisant la console web :

     1. Naviguez jusqu'à la page Administration → Cluster Settings.
     2. Cliquez sur Configuration pour afficher toutes les ressources de configuration.
     3. Trouvez l'entrée pour Project et cliquez sur Edit YAML.

   • Utilisation de la CLI :

     1. Connectez-vous en tant qu'utilisateur disposant des privilèges cluster-admin.

     2. Modifier la ressource project.config.openshift.io/cluster:

        $ oc edit project.config.openshift.io/cluster

        Copy to Clipboard Toggle word wrap

2. Mettez à jour la section spec pour inclure le paramètre projectRequestMessage et définissez la valeur de votre message personnalisé :

   Ressource de configuration de projet avec message de demande de projet personnalisé

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestMessage: <message_string>

   Copy to Clipboard Toggle word wrap

   Par exemple :

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestMessage: To request a project, contact your system administrator at projectname@example.com.

   Copy to Clipboard Toggle word wrap
3. Après avoir enregistré vos modifications, essayez de créer un nouveau projet en tant que développeur ou compte de service qui n'est pas en mesure d'auto-provisionner des projets afin de vérifier que vos modifications ont été appliquées avec succès.

Procédure

1. Dans la vue Add, cliquez sur la tuile Samples pour afficher la page Samples.
2. Sur la page Samples, sélectionnez l'un des exemples de candidature disponibles pour voir le formulaire Create Sample Application.

3. Sur le site Create Sample Application Form:

   • Dans le champ Name, le nom du déploiement est affiché par défaut. Vous pouvez modifier ce nom si nécessaire.
   • Dans le site Builder Image Version, une image de constructeur est sélectionnée par défaut. Vous pouvez modifier cette version de l'image en utilisant la liste déroulante Builder Image Version.
   • Un exemple d'URL de dépôt Git est ajouté par défaut.
4. Cliquez sur Create pour créer l'exemple d'application. L'état de construction de l'application d'exemple est affiché sur la vue Topology. Une fois l'application exemple créée, vous pouvez voir le déploiement ajouté à l'application.

Procédure

1. Dans la vue Add, cliquez sur le lien View all quick starts pour afficher la page Quick Starts.
2. Dans la page Quick Starts, cliquez sur la tuile correspondant au démarrage rapide que vous souhaitez utiliser.
3. Cliquez sur Start pour commencer le démarrage rapide.

Procédure

1. Dans la vue Add, cliquez sur From Git dans la tuile Git Repository pour afficher le formulaire Import from git.
2. Dans la section Git, entrez l'URL du dépôt Git pour la base de code que vous souhaitez utiliser pour créer une application. Par exemple, entrez l'URL de cet exemple d'application Node.js https://github.com/sclorg/nodejs-ex. L'URL est ensuite validée.

3. Facultatif : vous pouvez cliquer sur Show Advanced Git Options pour ajouter des détails tels que

   • Git Reference pour pointer vers le code d'une branche, d'une balise ou d'un commit spécifique à utiliser pour construire l'application.
   • Context Dir pour spécifier le sous-répertoire du code source de l'application que vous voulez utiliser pour construire l'application.
   • Source Secret pour créer un site Secret Name avec des informations d'identification permettant d'extraire votre code source d'un dépôt privé.

4. Facultatif : vous pouvez importer un fichier de développement, un fichier Docker ou une image de construction via votre dépôt Git pour personnaliser davantage votre déploiement.

   • Si votre dépôt Git contient un fichier devfile, un fichier Docker ou une image builder, il est automatiquement détecté et renseigné dans les champs de chemin respectifs. Si un fichier devfile, un fichier Docker et une image builder sont détectés dans le même dépôt, le fichier devfile est sélectionné par défaut.
   • Pour modifier le type d'importation de fichiers et sélectionner une stratégie différente, cliquez sur l'option Edit import strategy.
   • Si plusieurs devfiles, Dockerfiles ou images de constructeur sont détectés, pour importer un devfile, un Dockerfile ou une image de constructeur spécifique, spécifiez les chemins respectifs relatifs au répertoire contextuel.

5. Une fois l'URL Git validée, l'image du constructeur recommandée est sélectionnée et marquée d'une étoile. Si l'image du constructeur n'est pas détectée automatiquement, sélectionnez-en une. Pour l'URL https://github.com/sclorg/nodejs-ex Git, l'image du constructeur Node.js est sélectionnée par défaut.

   1. Facultatif : Utilisez la liste déroulante Builder Image Version pour spécifier une version.
   2. En outre, il est possible de choisir une stratégie différente en utilisant le site : Utilisez le site Edit import strategy pour sélectionner une autre stratégie.
   3. Facultatif : Pour l'image du constructeur Node.js, utilisez le champ Run command pour remplacer la commande d'exécution de l'application.

6. Dans la section General:

   1. Dans le champ Application, saisissez un nom unique pour le groupe d'applications, par exemple myapp. Assurez-vous que le nom de l'application est unique dans un espace de noms.

   2. Le champ Name pour identifier les ressources créées pour cette application est automatiquement rempli sur la base de l'URL du dépôt Git s'il n'y a pas d'applications existantes. S'il y a des applications existantes, vous pouvez choisir de déployer le composant dans une application existante, de créer une nouvelle application ou de garder le composant non assigné.

      Note

      Le nom de la ressource doit être unique dans un espace de noms. Modifiez le nom de la ressource si vous obtenez une erreur.

7. Dans la section Resources, sélectionnez :

   • Deploymentil s'agit de créer une application à la manière de Kubernetes.
   • Deployment Configl'objectif est de créer une application de type OpenShift Container Platform.

   • Serverless Deploymentpour créer un service Knative.

     Note

     Vous pouvez définir la préférence de ressource par défaut pour l'importation en parcourant la page Préférences utilisateur et en cliquant sur Applications → champ Resource type. L'option Serverless Deployment s'affiche dans le formulaire Import from Git uniquement si l'opérateur OpenShift Serverless est installé dans votre cluster. Pour plus de détails, reportez-vous à la documentation d'OpenShift Serverless.

8. Dans la section Pipelines, sélectionnez Add Pipeline, puis cliquez sur Show Pipeline Visualization pour voir le pipeline de l'application. Un pipeline par défaut est sélectionné, mais vous pouvez choisir le pipeline que vous souhaitez dans la liste des pipelines disponibles pour l'application.

9. Facultatif : dans la section Advanced Options, les adresses Target port et Create a route to the application sont sélectionnées par défaut afin que vous puissiez accéder à votre application à l'aide d'une URL publique.

   Si votre application n'expose pas ses données sur le port public par défaut, 80, décochez la case et définissez le numéro du port cible que vous souhaitez exposer.

10. Facultatif : Vous pouvez utiliser les options avancées suivantes pour personnaliser davantage votre application :

Procédure

1. Dans la vue Topology, cliquez avec le bouton droit de la souris n'importe où dans la vue Topology pour afficher le menu Add to Project.
2. Survolez le menu Add to Project pour voir les options du menu, puis sélectionnez l'option Upload JAR file pour voir le formulaire Upload JAR file. Vous pouvez également faire glisser et déposer le fichier JAR dans la vue Topology.
3. Dans le champ JAR file, recherchez le fichier JAR requis sur votre machine locale et téléchargez-le. Vous pouvez également glisser-déposer le fichier JAR dans le champ. Un message d'alerte s'affiche en haut à droite si un type de fichier incompatible est glissé-déposé dans la vue Topology. Une erreur de champ s'affiche si un type de fichier incompatible est déposé sur le champ dans le formulaire de téléchargement.
4. Vous pouvez également spécifier des commandes Java optionnelles pour personnaliser votre application déployée. L'icône d'exécution et l'image du constructeur sont sélectionnées par défaut. Si une image de constructeur n'est pas détectée automatiquement, sélectionnez-en une. Si nécessaire, vous pouvez modifier la version à l'aide de la liste déroulante Builder Image Version.
5. Dans le champ facultatif Application Name, saisissez un nom unique pour votre application d'étiquetage des ressources.
6. Dans le champ Name, saisissez un nom de composant unique pour les ressources associées.
7. Facultatif : Dans la liste déroulante Advanced options → Resource type, sélectionnez un autre type de ressource dans la liste des types de ressources par défaut.
8. Dans le site Advanced options, cliquez sur Create a Route to the Application pour configurer une URL publique pour votre application déployée.

9. Cliquez sur Create pour déployer l'application. L'utilisateur voit une notification de toast l'informant que le fichier JAR est en train d'être téléchargé et que cela prend un certain temps. La notification de toast comprend également un lien permettant de consulter les journaux de construction.

   Note

   Si l'utilisateur tente de fermer l'onglet du navigateur pendant que la construction est en cours, une alerte web s'affiche pour demander à l'utilisateur s'il souhaite réellement quitter la page.

Procédure

1. Naviguez vers Developer Perspective → Add → Developer Catalog → All Services. Une liste de tous les services disponibles sur le site Developer Catalog s'affiche.
2. Sous All Services, sélectionnez Devfiles pour rechercher les fichiers de développement qui prennent en charge un langage ou un cadre particulier. Vous pouvez également utiliser le filtre par mot-clé pour rechercher un fichier de développement particulier à l'aide de son nom, de son étiquette ou de sa description.
3. Cliquez sur le fichier de développement que vous souhaitez utiliser pour créer une application. La tuile devfile affiche les détails du devfile, y compris le nom, la description, le fournisseur et la documentation du devfile.
4. Cliquez sur Create pour créer une application et la visualiser dans la vue Topology.

Procédure

1. Dans la perspective Developer, naviguez jusqu'à la vue Add et, à partir de la tuile Developer Catalog, cliquez sur All Services pour afficher tous les services disponibles sur Developer Catalog.
2. Sous All Services, sélectionnez le type de service ou le composant que vous devez ajouter à votre projet. Pour cet exemple, sélectionnez Databases pour obtenir la liste de tous les services de base de données, puis cliquez sur MariaDB pour afficher les détails du service.

3. Cliquez sur Instantiate Template pour afficher un modèle automatiquement rempli avec les détails du service MariaDB, puis cliquez sur Create pour créer et afficher le service MariaDB dans la vue Topology.

   Figure 3.1. MariaDB dans la topologie

   

   View larger image

   

Procédure

1. Créez un nouveau projet dans la console web d'OpenShift Container Platform pour cette procédure. Cet exemple utilise un projet appelé my-etcd.

2. Naviguez jusqu'à la page Operators → Installed Operators. Les opérateurs qui ont été installés sur la grappe par l'administrateur de la grappe et qui sont disponibles pour être utilisés sont affichés ici sous la forme d'une liste de versions de service de grappe (CSV). Les CSV sont utilisées pour lancer et gérer le logiciel fourni par l'opérateur.

   Astuce

   Vous pouvez obtenir cette liste à partir de l'interface de programmation en utilisant :

   $ oc get csv

   Copy to Clipboard Toggle word wrap

3. Sur la page Installed Operators, cliquez sur l'opérateur etcd pour obtenir plus de détails et connaître les actions disponibles.

   Comme indiqué sous Provided APIs, cet opérateur met à disposition trois nouveaux types de ressources, dont un pour un etcd Cluster (la ressource EtcdCluster ). Ces objets fonctionnent de la même manière que les objets Kubernetes natifs intégrés, tels que Deployment ou ReplicaSet, mais contiennent une logique spécifique à la gestion de etcd.

4. Créer un nouveau cluster etcd :

   1. Dans la boîte API etcd Cluster, cliquez sur Create instance.
   2. L'écran suivant vous permet d'apporter des modifications au modèle minimal de départ d'un objet EtcdCluster, comme la taille de l'amas. Pour l'instant, cliquez sur Create pour finaliser. Cela déclenche le démarrage par l'opérateur des pods, des services et des autres composants du nouveau cluster etcd.

5. Cliquez sur le cluster etcd example, puis sur l'onglet Resources pour voir que votre projet contient maintenant un certain nombre de ressources créées et configurées automatiquement par l'Opérateur.

   Vérifiez qu'un service Kubernetes a été créé pour vous permettre d'accéder à la base de données depuis d'autres pods de votre projet.

6. Tous les utilisateurs ayant le rôle edit dans un projet donné peuvent créer, gérer et supprimer des instances d'application (un cluster etcd, dans cet exemple) gérées par des opérateurs qui ont déjà été créés dans le projet, en libre-service, comme dans un service en nuage. Si vous souhaitez donner cette possibilité à d'autres utilisateurs, les administrateurs du projet peuvent ajouter le rôle à l'aide de la commande suivante :

   $ oc policy add-role-to-user edit <user> -n <target_project>

   Copy to Clipboard Toggle word wrap

Procédure

1. Dans la perspective Administrator de la console web, naviguez vers Operators → OperatorHub.
2. Utilisez la boîte Filter by keyword pour rechercher Service Binding Operator dans le catalogue. Cliquez sur la tuile Service Binding Operator.
3. Lisez la brève description de l'opérateur sur la page Service Binding Operator. Cliquez sur Install.

4. Sur la page Install Operator:

   1. Sélectionnez All namespaces on the cluster (default) pour l'espace de noms Installation Mode. Ce mode installe l'opérateur dans l'espace de noms par défaut openshift-operators, ce qui permet à l'opérateur de surveiller tous les espaces de noms du cluster et d'y avoir accès.
   2. Sélectionnez Automatic pour la stratégie d'approbation Approval Strategy. Cela garantit que les futures mises à niveau de l'opérateur sont gérées automatiquement par le gestionnaire du cycle de vie de l'opérateur (OLM). Si vous sélectionnez la stratégie d'approbation Manual, OLM crée une demande de mise à jour. En tant qu'administrateur de cluster, vous devez ensuite approuver manuellement la demande de mise à jour OLM pour mettre à jour l'opérateur vers la nouvelle version.

   3. Sélectionnez un site Update Channel.

      • Par défaut, le canal stable permet l'installation de la dernière version stable et prise en charge de l'opérateur de liaison de services.

5. Cliquez sur Install.

   Note

   L'opérateur est installé automatiquement dans l'espace de noms openshift-operators.

6. Dans le volet Installed Operator — ready for use, cliquez sur View Operator. Vous verrez l'opérateur listé sur la page Installed Operators.
7. Vérifiez que Status est défini sur Succeeded pour confirmer la réussite de l'installation de l'opérateur de reliure de service.

Procédure

1. Créez le CR PostgresCluster dans l'espace de noms my-petclinic en exécutant la commande suivante dans l'interpréteur de commandes :

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: postgres-operator.crunchydata.com/v1beta1
   kind: PostgresCluster
   metadata:
     name: hippo
   spec:
     image: registry.developers.crunchydata.com/crunchydata/crunchy-postgres:ubi8-14.4-0
     postgresVersion: 14
     instances:
       - name: instance1
         dataVolumeClaimSpec:
           accessModes:
           - "ReadWriteOnce"
           resources:
             requests:
               storage: 1Gi
     backups:
       pgbackrest:
         image: registry.developers.crunchydata.com/crunchydata/crunchy-pgbackrest:ubi8-2.38-0
         repos:
         - name: repo1
           volume:
             volumeClaimSpec:
               accessModes:
               - "ReadWriteOnce"
               resources:
                 requests:
                   storage: 1Gi
   EOD

   Copy to Clipboard Toggle word wrap

   Les annotations ajoutées dans cette CR PostgresCluster activent la connexion de liaison de service et déclenchent le rapprochement de l'opérateur.

   La sortie vérifie que l'instance de la base de données est créée :

   Exemple de sortie

   postgrescluster.postgres-operator.crunchydata.com/hippo created

   Copy to Clipboard Toggle word wrap

2. Après avoir créé l'instance de la base de données, assurez-vous que tous les pods de l'espace de noms my-petclinic sont en cours d'exécution :

   $ oc get pods -n my-petclinic

   Copy to Clipboard Toggle word wrap

   La sortie, qui prend quelques minutes à s'afficher, vérifie que la base de données est créée et configurée :

   Exemple de sortie

   NAME                                     READY    STATUS      RESTARTS   AGE
   hippo-backup-9rxm-88rzq                   0/1     Completed   0          2m2s
   hippo-instance1-6psd-0                    4/4     Running     0          3m28s
   hippo-repo-host-0                         2/2     Running     0          3m28s

   Copy to Clipboard Toggle word wrap

   Une fois la base de données configurée, vous pouvez déployer l'application d'exemple et la connecter au service de base de données.

Procédure

1. Déployez l'application spring-petclinic avec la ressource personnalisée (CR) PostgresCluster en exécutant la commande suivante dans le shell :

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: spring-petclinic
     labels:
       app: spring-petclinic
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: spring-petclinic
     template:
       metadata:
         labels:
           app: spring-petclinic
       spec:
         containers:
           - name: app
             image: quay.io/service-binding/spring-petclinic:latest
             imagePullPolicy: Always
             env:
             - name: SPRING_PROFILES_ACTIVE
               value: postgres
             ports:
             - name: http
               containerPort: 8080
   ---
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: spring-petclinic
     name: spring-petclinic
   spec:
     type: NodePort
     ports:
       - port: 80
         protocol: TCP
         targetPort: 8080
     selector:
       app: spring-petclinic
   EOD

   Copy to Clipboard Toggle word wrap

   La sortie vérifie que l'exemple d'application Spring PetClinic est créé et déployé :

   Exemple de sortie

   deployment.apps/spring-petclinic created
   service/spring-petclinic created

   Copy to Clipboard Toggle word wrap

   Note

   Si vous déployez l'application à l'aide de Container images dans la perspective Developer de la console web, vous devez entrer les variables d'environnement suivantes dans la section Deployment de la page Advanced options:

   • Nom : SPRING_PROFILES_ACTIVE
   • Valeur : postgres

2. Vérifiez que l'application n'est pas encore connectée au service de base de données en exécutant la commande suivante :

   $ oc get pods -n my-petclinic

   Copy to Clipboard Toggle word wrap

   La sortie prend quelques minutes pour afficher l'état de CrashLoopBackOff:

   Exemple de sortie

   NAME                                READY   STATUS             RESTARTS      AGE
   spring-petclinic-5b4c7999d4-wzdtz   0/1     CrashLoopBackOff   4 (13s ago)   2m25s

   Copy to Clipboard Toggle word wrap

   À ce stade, le pod ne démarre pas. Si vous essayez d'interagir avec l'application, elle renvoie des erreurs.

3. Exposez le service pour créer une route pour votre application :

   $ oc expose service spring-petclinic -n my-petclinic

   Copy to Clipboard Toggle word wrap

   La sortie vérifie que le service spring-petclinic est exposé et qu'une route pour l'exemple d'application Spring PetClinic est créée :

   Exemple de sortie

   route.route.openshift.io/spring-petclinic exposed

   Copy to Clipboard Toggle word wrap

Procédure

1. Créez un CR ServiceBinding pour projeter les données de la reliure :

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: binding.operators.coreos.com/v1alpha1
   kind: ServiceBinding
   metadata:
     name: spring-petclinic-pgcluster
   spec:
     services: 

   1

   
       - group: postgres-operator.crunchydata.com
         version: v1beta1
         kind: PostgresCluster 

   2

   
         name: hippo
     application: 

   3

   
       name: spring-petclinic
       group: apps
       version: v1
       resource: deployments
   EOD

   Copy to Clipboard Toggle word wrap

   1

   Spécifie une liste de ressources de service.

   2

   Le CR de la base de données.

   3

   L'exemple d'application qui pointe vers un déploiement ou toute autre ressource similaire avec une PodSpec intégrée.

   La sortie vérifie que le CR ServiceBinding est créé pour projeter les données de reliure dans l'exemple d'application.

   Exemple de sortie

   servicebinding.binding.operators.coreos.com/spring-petclinic created

   Copy to Clipboard Toggle word wrap

2. Vérifier que la demande de liaison de service a abouti :

   $ oc get servicebindings -n my-petclinic

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   NAME                         READY   REASON              AGE
   spring-petclinic-pgcluster   True    ApplicationsBound   7s

   Copy to Clipboard Toggle word wrap

   Par défaut, les valeurs des données de liaison du service de base de données sont projetées sous forme de fichiers dans le conteneur de charge de travail qui exécute l'exemple d'application. Par exemple, toutes les valeurs de la ressource Secret sont projetées dans le répertoire bindings/spring-petclinic-pgcluster.

   Note

   En option, vous pouvez également vérifier que les fichiers de l'application contiennent les données de reliure projetées, en imprimant le contenu du répertoire :

   $ for i in username password host port type; do oc exec -it deploy/spring-petclinic -n my-petclinic -- /bin/bash -c 'cd /tmp; find /bindings/*/'$i' -exec echo -n {}:" " \; -exec cat {} \;'; echo; done

   Copy to Clipboard Toggle word wrap

   Exemple de résultat : Avec toutes les valeurs de la ressource secrète

   /bindings/spring-petclinic-pgcluster/username: hippo
   /bindings/spring-petclinic-pgcluster/password: KXKF{nAI,I-J6zLt:W+FKnze
   /bindings/spring-petclinic-pgcluster/host: hippo-primary.my-petclinic.svc
   /bindings/spring-petclinic-pgcluster/port: 5432
   /bindings/spring-petclinic-pgcluster/type: postgresql

   Copy to Clipboard Toggle word wrap

3. Configurez le transfert de port à partir du port d'application pour accéder à l'exemple d'application à partir de votre environnement local :

   $ oc port-forward --address 0.0.0.0 svc/spring-petclinic 8080:80 -n my-petclinic

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   Forwarding from 0.0.0.0:8080 -> 8080
   Handling connection for 8080

   Copy to Clipboard Toggle word wrap

4. Accès http://localhost:8080/petclinic.

   Vous pouvez maintenant accéder à distance à l'application d'exemple Spring PetClinic sur localhost:8080 et constater que l'application est désormais connectée au service de base de données.

Procédure

1. Pour déployer l'opérateur PostgreSQL de Dev4Devs dans l'espace de noms my-petclinic, exécutez la commande suivante dans l'interpréteur de commandes :

Vérification

1. Une fois l'opérateur installé, dressez la liste des abonnements à l'opérateur dans l'espace de noms openshift-operators:

   $ oc get subs -n openshift-operators

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   NAME                               PACKAGE                            SOURCE                  CHANNEL
   postgresql-operator-dev4devs-com   postgresql-operator-dev4devs-com   ibm-multiarch-catalog   alpha
   rh-service-binding-operator        rh-service-binding-operator        redhat-operators        stable

   Copy to Clipboard Toggle word wrap

Procédure

1. Créez le CR Database dans l'espace de noms my-petclinic en exécutant la commande suivante dans l'interpréteur de commandes :

   $ oc apply -f - << EOD
   apiVersion: postgresql.dev4devs.com/v1alpha1
   kind: Database
   metadata:
     name: sampledatabase
     namespace: my-petclinic
     annotations:
       host: sampledatabase
       type: postgresql
       port: "5432"
       service.binding/database: 'path={.spec.databaseName}'
       service.binding/port: 'path={.metadata.annotations.port}'
       service.binding/password: 'path={.spec.databasePassword}'
       service.binding/username: 'path={.spec.databaseUser}'
       service.binding/type: 'path={.metadata.annotations.type}'
       service.binding/host: 'path={.metadata.annotations.host}'
   spec:
     databaseCpu: 30m
     databaseCpuLimit: 60m
     databaseMemoryLimit: 512Mi
     databaseMemoryRequest: 128Mi
     databaseName: "sampledb"
     databaseNameKeyEnvVar: POSTGRESQL_DATABASE
     databasePassword: "samplepwd"
     databasePasswordKeyEnvVar: POSTGRESQL_PASSWORD
     databaseStorageRequest: 1Gi
     databaseUser: "sampleuser"
     databaseUserKeyEnvVar: POSTGRESQL_USER
     image: registry.redhat.io/rhel8/postgresql-13:latest
     databaseStorageClassName: nfs-storage-provisioner
     size: 1
   EOD

   Copy to Clipboard Toggle word wrap

   Les annotations ajoutées dans cette CR Database activent la connexion de liaison de service et déclenchent le rapprochement de l'opérateur.

   La sortie vérifie que l'instance de la base de données est créée :

   Exemple de sortie

   database.postgresql.dev4devs.com/sampledatabase created

   Copy to Clipboard Toggle word wrap

2. Après avoir créé l'instance de la base de données, assurez-vous que tous les pods de l'espace de noms my-petclinic sont en cours d'exécution :

   $ oc get pods -n my-petclinic

   Copy to Clipboard Toggle word wrap

   La sortie, qui prend quelques minutes à s'afficher, vérifie que la base de données est créée et configurée :

   Exemple de sortie

   NAME                                     READY    STATUS      RESTARTS   AGE
   sampledatabase-cbc655488-74kss            0/1     Running        0       32s

   Copy to Clipboard Toggle word wrap