3.2. Créer des applications en utilisant la perspective Développeur

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