Applications de construction

1. Dans la perspective Développeur, accédez à la page Projet.
2. Choisissez votre projet dans le menu Projet.
3. Cliquez sur l’onglet Accès au projet.

4. Cliquez sur Ajouter un accès pour ajouter une nouvelle ligne d’autorisations aux autorisations par défaut.

   Figure 2.2. Autorisations de projet

   

   View larger image

   
5. Entrez le nom d’utilisateur, cliquez sur la liste déroulante Sélectionner un rôle et sélectionnez un rôle approprié.
6. Cliquez sur Enregistrer pour ajouter les nouvelles autorisations.

Procédure

1. Dans la perspective de l’administrateur, accédez aux paramètres Administration → Cluster.
2. Cliquez sur l’onglet Configuration.
3. Dans la liste des ressources de configuration, sélectionnez Console operator.openshift.io.
4. Accédez à l’onglet YAML pour afficher et modifier le code YAML.

5. Dans le code YAML sous Spéc, personnalisez la liste des rôles de cluster disponibles pour l’accès au projet. L’exemple suivant spécifie les rôles d’administrateur, d’édition et de visualisation par défaut:

   apiVersion: operator.openshift.io/v1
   kind: Console
   metadata:
     name: cluster
   # ...
   spec:
     customization:
       projectAccess:
         availableClusterRoles:
         - admin
         - edit
         - view

   Copy to Clipboard Toggle word wrap
6. Cliquez sur Enregistrer pour enregistrer les modifications apportées à la ressource de configuration de la console.

La vérification

1. Dans la perspective Développeur, accédez à la page Projet.
2. Choisissez un projet dans le menu Projet.
3. Cliquez sur l’onglet Accès au projet.
4. Cliquez sur le menu dans la colonne Rôle et vérifiez que les rôles disponibles correspondent à la configuration que vous avez appliquée à la configuration de ressource de la console.

Procédure

1. Dans la perspective Développeur, accédez à la page +Ajouter.
2. Choisissez votre projet dans le menu Projet.
3. Cliquez sur un élément de la page +Ajouter, puis suivez le flux de travail.

Procédure

1. Connectez-vous en tant qu’utilisateur avec 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. Créez 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. Éditez la ressource de configuration du projet à l’aide de la console Web ou du CLI.

   • En utilisant la console web:

     1. Accédez à la page Administration → Paramètres du cluster.
     2. Cliquez sur Configuration pour afficher toutes les ressources de configuration.
     3. Cherchez l’entrée pour Projet et cliquez sur Modifier YAML.

   • En utilisant le CLI:

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

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

        Copy to Clipboard Toggle word wrap

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

   Configuration du projet ressource 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 été appliquées avec succès.

Procédure

1. Connectez-vous en tant qu’utilisateur avec des privilèges cluster-admin.

2. Affichez l’utilisation de la liaison de rôle du cluster auto-fournisseur 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

   Examiner les sujets dans la section des autoprovisionnaires.

3. Enlevez le rôle de cluster d’auto-fournisseur du système de groupe:authenticated:oauth.

   • Lorsque la liaison de rôle du cluster auto-fournisseur lie uniquement le rôle d’auto-fournisseur au système:authenticated:oauth group, exécutez la commande suivante:

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

     Copy to Clipboard Toggle word wrap

   • Lorsque la liaison de rôle de cluster auto-fournisseur lie le rôle d’auto-fournisseur à 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. Éditez la liaison du rôle de cluster d’auto-fournisseurs 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.

   • De mettre à jour la liaison de rôle à l’aide de l’ICC:

     1. Exécutez la commande suivante:

        $ oc edit clusterrolebinding.rbac self-provisioners

        Copy to Clipboard Toggle word wrap

     2. Dans la liaison 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

   • De mettre à jour la liaison de rôle en utilisant 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 ne peut plus 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

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

Procédure

1. Éditez la ressource de configuration du projet à l’aide de la console Web ou du CLI.

   • En utilisant la console web:

     1. Accédez à la page Administration → Paramètres du cluster.
     2. Cliquez sur Configuration pour afficher toutes les ressources de configuration.
     3. Cherchez l’entrée pour Projet et cliquez sur Modifier YAML.

   • En utilisant le CLI:

     1. Connectez-vous en tant qu’utilisateur avec des privilèges cluster-admin.

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

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

        Copy to Clipboard Toggle word wrap

2. Actualisez la section Spécifications pour inclure le paramètre projectRequestMessage et définissez la valeur à votre message personnalisé:

   Configuration du projet ressource avec message personnalisé de demande de projet

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

   Copy to Clipboard Toggle word wrap

   À titre d’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 pour vérifier que vos modifications ont été appliquées avec succès.

Procédure

1. Choisissez Développeur dans le sélecteur de contexte en haut du menu de navigation de la console Web.
2. Dans le projet souhaité, cliquez sur +Ajouter
3. Cliquez sur Tous les services dans la tuile du catalogue des développeurs.

4. Cliquez sur Builder Images sous Type pour voir les images du constructeur disponibles.

   Note

   Les balises de flux d’images qui ont la balise constructeur listée dans leurs annotations apparaissent dans cette liste, comme démontré ici:

   kind: "ImageStream"
   apiVersion: "image.openshift.io/v1"
   metadata:
     name: "ruby"
     creationTimestamp: null
   spec:
   # ...
     tags:
       - name: "2.6"
         annotations:
           description: "Build and run Ruby 2.6 applications"
           iconClass: "icon-ruby"
           tags: "builder,ruby" 

   1

   
           supports: "ruby:2.6,ruby"
           version: "2.6"
   # ...

   Copy to Clipboard Toggle word wrap

   1

   Inclure le constructeur ici s’assure que cette balise de flux d’images apparaît dans la console Web en tant que constructeur.

5. Modifiez les paramètres dans le nouvel écran de l’application pour configurer les objets pour prendre en charge votre application.

Procédure

1. Dans la vue +Ajouter, cliquez sur la tuile Échantillons pour voir la page Échantillons.
2. Dans la page Échantillons, sélectionnez l’une des applications types disponibles pour voir le formulaire Créer une demande d’échantillon.

3. Dans le formulaire de demande d’échantillon:

   • Dans le champ Nom, le nom de déploiement est affiché par défaut. Il est possible de modifier ce nom au besoin.
   • Dans la version d’image du constructeur, une image de constructeur est sélectionnée par défaut. Cette version d’image peut être modifiée à l’aide de la liste déroulante de la version déroulante de Builder Image.
   • L’URL du référentiel Git est ajoutée par défaut.
4. Cliquez sur Créer pour créer l’exemple d’application. L’état de construction de l’application de l’échantillon est affiché sur la vue Topology. Après la création de l’exemple d’application, vous pouvez voir le déploiement ajouté à l’application.

Procédure

1. Dans la vue +Ajouter, cliquez sur le lien Démarrer les ressources → Construire avec la documentation guidée → Voir tous les liens de démarrage rapide pour afficher la page Démarrage rapide.
2. Dans la page Démarrage rapide, cliquez sur la tuile pour le démarrage rapide que vous souhaitez utiliser.
3. Cliquez sur Démarrer pour commencer le démarrage rapide.
4. Effectuez les étapes qui sont affichées.

Procédure

1. Dans la vue +Ajouter, cliquez sur À partir de Git dans la tuile Git Repository pour voir le formulaire Importer à partir de git.
2. Dans la section Git, entrez l’URL du référentiel Git pour la base de code que vous souhaitez utiliser pour créer une application. Entrez par exemple 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 Afficher les options avancées de Git pour ajouter des détails tels que:

   • Git Référence au point de code d’une branche, d’une balise ou d’un engagement spécifique pour être utilisé pour construire l’application.
   • Context Dir pour spécifier le sous-répertoire du code source de l’application que vous souhaitez utiliser pour construire l’application.
   • Créer un nom secret avec des informations d’identification pour tirer votre code source d’un référentiel privé.

4. Facultatif : Vous pouvez importer un fichier Devfile, un Dockerfile, une image Builder ou une fonction sans serveur via votre référentiel Git pour personnaliser davantage votre déploiement.

   • Lorsque votre dépôt Git contient un Devfile, un Dockerfile, une image Builder ou un func.yaml, il est automatiquement détecté et peuplé sur les champs de chemin respectifs.
   • Lorsqu’un Devfile, un Dockerfile ou une image Builder sont détectés dans le même référentiel, le Devfile est sélectionné par défaut.
   • Lorsque func.yaml est détecté dans le référentiel Git, la stratégie d’importation change de fonction sans serveur.
   • Alternativement, vous pouvez créer une fonction sans serveur en cliquant sur Créer la fonction Serverless dans la vue +Ajouter à l’aide de l’URL du référentiel Git.
   • Afin d’éditer le type d’importation de fichier et de sélectionner une stratégie différente, cliquez sur Modifier la stratégie d’importation.
   • Lorsque plusieurs Devfiles, Dockerfiles, ou un Builder Images sont détectés, pour importer une instance spécifique, spécifiez les chemins respectifs par rapport au répertoire contextuel.

5. Après la validation de l’URL Git, l’image de constructeur recommandée est sélectionnée et marquée d’une étoile. Lorsque l’image du constructeur n’est pas détectée automatiquement, sélectionnez une image de constructeur. Dans le cas de 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 le déroulant de la version déroulante de Builder Image pour spécifier une version.
   2. Facultatif: Utilisez la stratégie Modifier l’importation pour sélectionner une stratégie différente.
   3. Facultatif: Pour l’image du constructeur Node.js, utilisez le champ de commande Exécuter pour remplacer la commande pour exécuter l’application.

6. Dans la section générale:

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

   2. Le champ Nom pour identifier les ressources créées pour cette application est automatiquement rempli en fonction de l’URL du référentiel Git s’il n’y a pas d’applications existantes. Dans le cas d’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 affecté.

      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 Ressources, sélectionnez:

   • Déploiement, pour créer une application dans le style Kubernetes.
   • Déploiement Config, pour créer un service Red Hat OpenShift sur l’application de style AWS.

8. Dans la section Pipelines, sélectionnez Ajouter un pipeline, puis cliquez sur Afficher la visualisation des pipelines pour voir le pipeline pour l’application. Le 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.

   Note

   La case à cocher Ajouter un pipeline est cochée et Configure PAC est sélectionnée par défaut si les critères suivants sont remplis:

   • L’opérateur de pipeline est installé
   • les pipelines-as-code sont activés
   • le répertoire .Tekton est détecté dans le référentiel Git

9. Ajoutez un webhook à votre référentiel. Lorsque Configurez PAC est vérifié et que l’application GitHub est configurée, vous pouvez voir les options Utiliser l’application GitHub et configurer un webhook. Dans le cas où l’application GitHub n’est pas configurée, vous ne pouvez voir que l’option Configuration d’un webhook:

   1. Allez dans Paramètres → Webhooks et cliquez sur Ajouter webhook.
   2. Définissez l’URL Charge utile sur les pipelines en tant qu’URL publique du contrôleur de code.
   3. Choisissez le type de contenu comme application/json.
   4. Ajoutez un secret de webhook et notez-le dans un autre endroit. Avec Opensl installé sur votre machine locale, générez un secret aléatoire.
   5. Cliquez sur Laissez-moi sélectionner des événements individuels et sélectionnez ces événements: Commiter les commentaires, émettre des commentaires, Pull request et Pushes.
   6. Cliquez sur Ajouter webhook.

10. Facultatif : Dans la section Options avancées, le port cible et l’itinéraire Créer un itinéraire vers l’application sont sélectionnés par défaut afin que vous puissiez accéder à votre application à l’aide d’une URL accessible au public.

    Lorsque votre application n’expose pas ses données sur le port public par défaut, 80, effacer la case à cocher et définir le numéro de port cible que vous souhaitez exposer.

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

    Le routage

    En cliquant sur le lien de routage, vous pouvez effectuer les actions suivantes:

    • Personnalisez le nom d’hôte pour l’itinéraire.
    • Indiquez le chemin que le routeur montre.
    • Choisissez le port cible pour le trafic dans la liste déroulante.

    • Assurez votre itinéraire en sélectionnant la case à cocher Route sécurisée. Choisissez le type de terminaison TLS requis et définissez une stratégie pour le trafic non sécurisé à partir des listes déroulantes respectives.

      Note

      Dans le cas des applications sans serveur, le service Knative gère toutes les options de routage ci-dessus. Cependant, vous pouvez personnaliser le port cible pour le trafic, si nécessaire. Lorsque le port cible n’est pas spécifié, le port par défaut de 8080 est utilisé.

    Bilans de santé

    Cliquez sur le lien Health Checks pour ajouter des sondes de préparation, de vie et de démarrage à votre application. L’ensemble des sondes ont des données par défaut prépopulées; vous pouvez ajouter les sondes avec les données par défaut ou les personnaliser au besoin.

    Afin de personnaliser les sondes de santé:

    • Cliquez sur Ajouter la sonde de préparation, si nécessaire, modifiez les paramètres pour vérifier si le conteneur est prêt à traiter les demandes et sélectionnez la marque de cocher pour ajouter la sonde.
    • Cliquez sur Ajouter une sonde de vie, si nécessaire, modifiez les paramètres pour vérifier si un conteneur est toujours en cours d’exécution et sélectionnez la coche pour ajouter la sonde.

    • Cliquez sur Ajouter une sonde de démarrage, si nécessaire, modifiez les paramètres pour vérifier si l’application dans le conteneur a commencé et sélectionnez la coche pour ajouter la sonde.

      Dans chacune des sondes, vous pouvez spécifier le type de requête - HTTP GET, Container Command ou TCP Socket, à partir de la liste déroulante. Le formulaire change selon le type de demande sélectionné. Ensuite, vous pouvez modifier les valeurs par défaut pour les autres paramètres, tels que les seuils de succès et de défaillance de la sonde, le nombre de secondes avant d’effectuer la première sonde après le démarrage du conteneur, la fréquence de la sonde et la valeur d’expiration.

    Construire la configuration et le déploiement

    Cliquez sur les liens Configuration et déploiement pour voir les options de configuration respectives. Certaines options sont sélectionnées par défaut; vous pouvez les personnaliser davantage en ajoutant les déclencheurs et les variables d’environnement nécessaires.

    Dans le cas des applications sans serveur, l’option Déploiement n’est pas affichée car la ressource de configuration Knative maintient l’état souhaité pour votre déploiement au lieu d’une ressource DeploymentConfig.

    La mise à l’échelle

    Cliquez sur le lien Scaling pour définir le nombre de pods ou d’instances de l’application que vous souhaitez déployer initialement.

    Lorsque vous créez un déploiement sans serveur, vous pouvez également configurer les paramètres suivants:

    • Les Pods min déterminent la limite inférieure pour le nombre de gousses qui doivent fonctionner à tout moment pour un service Knative. Ceci est également connu sous le nom de paramètre minScale.
    • Les Max Pods déterminent la limite supérieure pour le nombre de gousses pouvant fonctionner à tout moment pour un service Knative. Ceci est également connu sous le nom de réglage maxScale.
    • La cible de concurrence détermine le nombre de demandes simultanées souhaitées pour chaque instance de la demande à un moment donné.
    • La limite de concurrence détermine la limite pour le nombre de demandes simultanées autorisées pour chaque instance de la demande à un moment donné.
    • L’utilisation de la concurrence détermine le pourcentage de la limite de demandes simultanées qui doit être respectée avant que Knative n’évolue de nouveaux pods pour gérer le trafic supplémentaire.
    • La fenêtre Autoscale définit la fenêtre de temps sur laquelle les métriques sont moyennes pour fournir une entrée pour les décisions de mise à l’échelle lorsque l’autoscaler n’est pas en mode panique. Le service est réduit à zéro si aucune demande n’est reçue pendant cette fenêtre. La durée par défaut de la fenêtre autoscale est 60s. Ceci est également connu sous le nom de fenêtre stable.

    Limite de ressources

    Cliquez sur le lien Limite de ressources pour définir la quantité de ressources CPU et mémoire qu’un conteneur est garanti ou autorisé à utiliser lors de l’exécution.

    Étiquettes

    Cliquez sur le lien Labels pour ajouter des étiquettes personnalisées à votre application.

12. Cliquez sur Créer pour créer l’application et une notification de succès est affichée. L’état de construction de l’application est affiché dans la vue Topology.

Procédure

1. Dans la vue +Ajouter, cliquez sur Container images pour afficher la page Deploy Images.

2. Dans la section Image:

   1. Choisissez le nom de l’image dans le registre externe pour déployer une image à partir d’un registre public ou privé, ou sélectionnez Image Stream tag dans le registre interne pour déployer une image à partir d’un registre interne.
   2. Choisissez une icône pour votre image dans l’onglet de l’icône Runtime.

3. Dans la section générale:

   1. Dans le champ Nom de l’application, entrez un nom unique pour le groupement d’applications.
   2. Dans le champ Nom, entrez un nom unique pour identifier les ressources créées pour ce composant.

4. Dans la section Type de ressource, sélectionnez le type de ressource à générer:

   1. Choisissez Déploiement pour activer les mises à jour déclaratives pour les objets Pod et ReplicaSet.
   2. Choisissez DéploymentConfig pour définir le modèle d’un objet Pod et gérer le déploiement de nouvelles images et sources de configuration.
5. Cliquez sur Create. Il est possible d’afficher l’état de construction de l’application dans la vue Topology.

Procédure

1. Dans la vue Topologie, faites un clic droit n’importe où pour afficher le menu Ajouter au projet.
2. Survolez le menu Ajouter au projet pour voir les options de menu, puis sélectionnez l’option Télécharger le fichier JAR pour afficher le formulaire de fichier JAR. Alternativement, vous pouvez glisser le fichier JAR dans la vue Topology.
3. Dans le champ fichier JAR, recherchez le fichier JAR requis sur votre machine locale et téléchargez-le. Alternativement, vous pouvez faire glisser le fichier JAR sur le champ. En haut à droite, une alerte toast est affichée si un type de fichier incompatible est glisser dans la vue Topology. L’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. L’icône d’exécution et l’image du constructeur sont sélectionnées par défaut. Lorsqu’une image de constructeur n’est pas détectée automatiquement, sélectionnez une image de constructeur. Au besoin, vous pouvez modifier la version à l’aide de la liste déroulante de la version déroulante de Builder Image.
5. Facultatif: Dans le champ Nom de l’application, entrez un nom unique pour votre application à utiliser pour l’étiquetage des ressources.
6. Dans le champ Nom, entrez un nom de composant unique pour les ressources associées.
7. Facultatif: Utilisez la liste déroulante type de ressource pour modifier le type de ressource.
8. Dans le menu Options avancées, cliquez sur Créer un itinéraire vers l’application pour configurer une URL publique pour votre application déployée.
9. Cliquez sur Créer pour déployer l’application. Il est indiqué qu’une notification de toast vous informe que le fichier JAR est en cours de téléchargement. La notification de toast comprend également un lien pour voir les journaux de construction.

Procédure

1. Accédez à Perspective des développeurs → +Ajouter → Catalogue des développeurs → Tous les services. La liste de tous les services disponibles dans le catalogue des développeurs est affichée.
2. Dans Type, cliquez sur Devfiles pour parcourir les devfiles qui prennent en charge un langage ou un framework particulier. Alternativement, vous pouvez utiliser le filtre de mots clés pour rechercher un devfile particulier en utilisant leur nom, leur balise ou leur description.
3. Cliquez sur le fichier devfile 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 Créer pour créer une application et afficher l’application dans la vue Topology.

Procédure

1. Dans la perspective Développeur, accédez à la vue +Ajouter et à partir de la tuile du catalogue des développeurs, cliquez sur Tous les services pour afficher tous les services disponibles dans le catalogue des développeurs.
2. Dans Tous les services, sélectionnez le type de service ou le composant que vous devez ajouter à votre projet. Dans cet exemple, sélectionnez Bases de données pour répertorier tous les services de base de données, puis cliquez sur MariaDB pour voir les détails du service.

3. Cliquez sur Instantiate Template pour voir un modèle automatiquement peuplé avec des détails pour le service MariaDB, puis cliquez sur Créer pour créer et afficher le service MariaDB dans la vue Topology.

   Figure 3.1. La MariaDB en topologie

   

   View larger image

   

Procédure

1. Créez un nouveau projet dans le Red Hat OpenShift Service sur la console web AWS pour cette procédure. Cet exemple utilise un projet appelé my-etcd.

2. Accédez à la page Opérateurs installés → Opérateurs installés. Les opérateurs qui ont été installés sur le cluster par l’administrateur dédié et qui sont disponibles pour utilisation sont présentés ici sous la forme d’une liste de versions de services de cluster (CSV). Les CSV sont utilisés pour lancer et gérer le logiciel fourni par l’opérateur.

   Astuce

   Cette liste peut être obtenue à partir du CLI en utilisant:

   $ oc get csv

   Copy to Clipboard Toggle word wrap

3. Dans la page Opérateurs installés, cliquez sur l’opérateur etcd pour voir plus de détails et les actions disponibles.

   Comme indiqué dans les API fournies, cet opérateur met à disposition trois nouveaux types de ressources, dont un pour un cluster etcd (la ressource EtcdCluster). Ces objets fonctionnent comme les Kubernetes natifs intégrés, tels que Déploiement ou ReplicaSet, mais contiennent une logique spécifique à la gestion etcd.

4. Créer un nouveau cluster etcd:

   1. Dans la zone API de cluster etcd, cliquez sur Créer une instance.
   2. La page suivante vous permet d’apporter des modifications au modèle de démarrage minimal d’un objet EtcdCluster, comme la taille du cluster. Cliquez pour l’instant sur Créer pour finaliser. Cela déclenche l’opérateur pour démarrer les pods, services et autres composants du nouveau cluster etcd.

5. Cliquez sur le cluster exemple etcd, puis cliquez sur l’onglet Ressources pour voir que votre projet contient maintenant un certain nombre de ressources créées et configurées automatiquement par l’opérateur.

   Assurez-vous qu’un service Kubernetes a été créé qui vous permet d’accéder à la base de données à partir d’autres pods de votre projet.

6. L’ensemble des utilisateurs ayant le rôle d’édition 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, de manière en libre-service, tout comme un service cloud. Lorsque vous souhaitez activer d’autres utilisateurs avec cette capacité, les administrateurs de 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. Installer la base de données:

   $ sudo yum install -y postgresql postgresql-server postgresql-devel

   Copy to Clipboard Toggle word wrap

2. Initialiser la base de données:

   $ sudo postgresql-setup initdb

   Copy to Clipboard Toggle word wrap

   Cette commande crée le répertoire /var/lib/pgsql/data, dans lequel les données sont stockées.

3. Démarrer la base de données:

   $ sudo systemctl start postgresql.service

   Copy to Clipboard Toggle word wrap

4. Lorsque la base de données est en cours d’exécution, créez votre utilisateur de rails:

   $ sudo -u postgres createuser -s rails

   Copy to Clipboard Toggle word wrap

   A noter que l’utilisateur créé n’a pas de mot de passe.

Procédure

1. Installez le gemme Rails:

   $ gem install rails

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   Successfully installed rails-4.3.0
   1 gem installed

   Copy to Clipboard Toggle word wrap

2. Après avoir installé le gemme Rails, créez une nouvelle application avec PostgreSQL comme base de données:

   $ rails new rails-app --database=postgresql

   Copy to Clipboard Toggle word wrap

3. Changez dans votre nouveau répertoire d’applications:

   $ cd rails-app

   Copy to Clipboard Toggle word wrap

4. Lorsque vous avez déjà une application, assurez-vous que le bijou pg (postgresql) est présent dans votre fichier Gemfile. Dans le cas contraire, modifiez votre Gemfile en ajoutant le gemme:

   gem 'pg'

   Copy to Clipboard Toggle word wrap

5. Générez un nouveau Gemfile.lock avec toutes vos dépendances:

   $ bundle install

   Copy to Clipboard Toggle word wrap

6. En plus d’utiliser la base de données postgresql avec le gemme pg, vous devez également vous assurer que la config/database.yml utilise l’adaptateur postgresql.

   Assurez-vous de mettre à jour la section par défaut dans le fichier config/database.yml, de sorte qu’il ressemble à ceci:

   default: &default
     adapter: postgresql
     encoding: unicode
     pool: 5
     host: localhost
     username: rails
     password: <password>

   Copy to Clipboard Toggle word wrap

7. Créez les bases de données de développement et de test de votre application:

   $ rake db:create

   Copy to Clipboard Toggle word wrap

   Cela crée une base de données de développement et de test dans votre serveur PostgreSQL.