Créer et configurer des travaux de production

Vous devez configurer des travaux de packaging et de déploiement pour pouvoir déployer des applications visuelles vers votre instance de production Visual Builder. Cette rubrique explique comment faire.

Conseil :

Si vous préférez, VB Studio peut créer et activer les travaux de build et le pipeline pour vous. Dans l'éditeur de paramètres de l'application visuelle, sous Création et publication, sélectionnez la branche de production, puis cliquez sur Créer un pipeline d'intégration continue et de déploiement continu. Vous pouvez ensuite modifier les travaux de build nouvellement créés si nécessaire (reportez-vous aux instructions ci-dessous pour plus d'informations sur les étapes de configuration). Par exemple, dans le travail de déploiement, la cible de déploiement est toujours l'environnement associé à l'espace de travail. Vous devrez donc remplacer l'instance cible par l'instance de production.

Avant de configurer les travaux de build de production, notez les points suivants :

  • Dans le travail d'empaquetage de production, utilisez la branche de production du référentiel Git pour générer des artefacts de production.
  • Dans le travail de packaging de développement, si vous avez modifié les noms de fichier par défaut des fichiers d'artefact d'archive, obtenez les nouveaux noms et leurs chemins. Vous en aurez besoin lorsque vous configurerez le travail d'emballage de production.
  • Si vous avez configuré le travail de packaging de développement de manière à écraser la version de l'application définie dans visual-application.json, obtenez la nouvelle version. Vous en aurez besoin lorsque vous configurerez le travail de packaging de production.
  • Lors de la configuration des travaux de build de déploiement, vous indiquez si la version de l'application doit être incluse dans son URL. Une application visuelle sans la version dans son URL est appelée une application en direct. En général, vous déployez une application active sur une instance de production.
  • Si vous déployez une version d'une application visuelle qui n'a jamais été déployée, VB Studio écrase la dernière version déployée avec la nouvelle version.

    VB Studio n'annule pas le déploiement de la version précédemment déployée à partir de l'instance de production. Il reste sur l'instance cible mais est inaccessible.

  • Si vous souhaitez redéployer une application active ou une version précédemment déployée, annulez d'abord son déploiement, sinon le build de déploiement échoue. Pour annuler le déploiement d'une version d'application visuelle déployée précédemment, configurez un travail d'annulation de déploiement et exécutez-le. Vous ne pouvez pas annuler son déploiement manuellement à partir de la page Environnements.
  • Si vous déployez une application vers une URL personnalisée, vous devez configurer le travail de déploiement pour qu'il soit déployé dans l'environnement hébergeant l'URL personnalisée. Vous pouvez uniquement déployer l'application à l'aide de l'authentification d'authentification de base. Vous devrez donc confirmer que les informations d'identification requises pour la connexion et le déploiement vers l'environnement sont correctes.
  • Si vous avez créé un profil d'application pour la production, obtenez son nom. Vous en aurez besoin lorsque vous configurerez le travail de déploiement de production.

Créer un travail de fabrication d'emballage de production

Le travail de packaging de production génère un artefact d'application visuelle prêt à être déployé.

  1. Dans le navigateur de gauche, cliquez sur Constructions Builds.
  2. Dans l'onglet Travaux, cliquez sur + Créer un travail.
  3. Dans la boîte de dialogue Nouveau travail, dans Nom, entrez un nom unique.
  4. Dans Description, entrez la description du travail.
  5. Dans Modèle, sélectionnez le modèle Valeur par défaut du système OL7 pour Visual Builder.
  6. Cliquez sur Créer.
  7. Cliquez sur Configurer Builds.
  8. Cliquez sur l'onglet Git.
  9. Dans la liste Ajouter Git, sélectionnez Git.
  10. Dans Référentiel, sélectionnez le référentiel Git. Dans Branche ou balise, sélectionnez la branche de production.
  11. Cliquez sur l'onglet Etapes.
  12. Dans Ajouter une étape, sélectionnez Application visuelle, puis Package.
  13. Par défaut, les travaux de build minifient le code source de l'application avant d'exécuter le build. Si vous ne souhaitez pas réduire les fichiers source, désélectionnez la case Optimiser l'application.
    La minification est un processus visant à supprimer les caractères inutiles (tels que les espaces vides, les nouvelles lignes et les commentaires) du code source et à réduire la taille des fichiers, ce qui fait que le transfert des fichiers consomme moins de bande passante et de stockage.
  14. Si vous souhaitez modifier les noms par défaut des fichiers d'archive, dans Noms de fichier, sélectionnez Utiliser des noms de fichier personnalisés.
    Dans Sources, indiquez le nom et le chemin du fichier d'archive source de l'application visuelle. Dans Créer un artefact, indiquez le nom et le chemin du fichier d'archive d'artefact de build.

    Vous aurez besoin des deux fichiers d'archive pour déployer l'application visuelle.

  15. Cliquez sur l'onglet Après la création.
  16. Dans Ajouter après l'action de build, sélectionnez Archiver d'artefacts.
  17. Dans Fichiers à archiver, entrez le nom de l'artefact de build. Vous pouvez également utiliser des caractères génériques. Par exemple, *.zip.
  18. Si vous souhaitez supprimer les anciens artefacts du build, cliquez sur Paramètres l'icône d'engrenage. Dans l'onglet Général, cochez la case Ignorer les anciens builds et indiquez les options d'annulation.
  19. Cliquez sur Enregistrer.

Créer un travail de build de déploiement de production

Le travail de déploiement de production déploie l'artefact de l'application visuelle qui a été généré dans le travail de packaging de production vers l'instance de production Visual Builder. Avant de créer le travail, obtenez les informations d'identification d'accès d'un utilisateur qui peut se connecter à l'instance de production Visual Builder et la déployer.

  1. Dans le navigateur de gauche, cliquez sur Constructions Builds.
  2. Dans l'onglet Travaux, cliquez sur + Créer un travail.
  3. Dans la boîte de dialogue Nouveau travail, dans Nom, entrez un nom unique.
  4. Dans Description, entrez la description du travail.
  5. Dans Modèle, sélectionnez le modèle Valeur par défaut du système OL7 pour Visual Builder.
  6. Cliquez sur Créer.
  7. Cliquez sur Configurer Builds.
  8. Cliquez sur l'onglet Avant la création.
  9. Dans Ajouter avant l'action de build, sélectionnez Copier les artefacts.
  10. Dans A partir du travail, sélectionnez le travail d'empaquetage de production qui a généré l'artefact de l'application visuelle.
  11. Dans Quel build, sélectionnez Dernier build exécuté avec succès.
  12. Laissez les autres champs avec leurs valeurs par défaut ou vides.
  13. Cliquez sur l'onglet Etapes.
  14. Dans Ajouter une étape, sélectionnez Application visuelle, puis Déployer.
  15. Dans Instance cible, sélectionnez l'instance de production Visual Builder.
  16. Dans la section Autorisation, indiquez le type d'autorisation pour exécuter cette étape de build. Une fois que l'option Utiliser OAuth est sélectionnée par défaut, le message Authorization is required apparaît. Il indique que cette étape de build a besoin d'une autorisation unique pour gérer les demandes OAuth vers l'instance Visual Builder de votre environnement. Cliquez sur Autoriser et entrez les informations d'identification pour accéder à votre instance Visual Builder. Vous pouvez également exécuter le travail manuellement et entrer les informations d'identification lorsque vous y êtes invité.

    Dans les deux cas, il est recommandé d'autoriser la connexion OAuth lors de la configuration initiale. Si vous ignorez cette étape, vous ne pourrez pas publier vos modifications à partir du concepteur et vous devrez terminer l'autorisation requise avant de tenter de déployer les modifications.

    Une fois autorisé, le message Authorization has been provided s'affiche.

    Remarque

    Le type d'autorisation recommandé est OAuth. Utilisez l'authentification de base uniquement si vous rencontrez des problèmes lors de la configuration d'une connexion OAuth. Pour utiliser l'authentification de base, sélectionnez Utiliser l'authentification de base, puis entrez les informations d'identification d'un utilisateur pouvant accéder à l'instance Visual Builder dans Nom utilisateur et Mot de passe.

    Les jetons OAuth (accès et actualisation) sont cyclés lors d'une utilisation régulière. Un jeton d'actualisation est utilisé pour obtenir un jeton d'accès chaque fois qu'un utilisateur accède à l'instance cible. Ce jeton d'actualisation est généralement valide pendant sept jours. (Le délai d'expiration du jeton est défini dans l'application de ressource IDCS et peut être différent en fonction de vos exigences de sécurité.) Si l'utilisateur s'authentifie auprès de l'instance cible au cours de la période de sept jours, le jeton d'actualisation actif génère un nouveau jeton d'accès et un nouveau jeton d'actualisation. Ce cycle se poursuit indéfiniment tant que le jeton d'actualisation reste valide. Si le jeton d'actualisation expire pendant de longues périodes d'inactivité (par exemple, lorsque vous êtes absent en vacances), cliquez sur Renouveler l'autorisation (ou exécutez le travail manuellement, de sorte que vous êtes invité à autoriser les jetons OAuth expirés).

  17. Dans le travail d'empaquetage de production, si vous avez modifié les noms de fichier par défaut des fichiers d'artefact d'archive, dans Noms de fichier, sélectionnez Utiliser des noms de fichier personnalisés.
    Dans Sources et Créer un artefact, entrez les mêmes noms de fichier (avec le chemin) que ceux spécifiés dans le travail de packaging.

    Si vous n'avez pas modifié les noms de fichier, utilisez l'option par défaut.

  18. (Facultatif) Si vous avez configuré le travail de déploiement de développement pour écraser la version par défaut de l'application, indiquez la même version dans Version de l'application. Laissez ce champ vide pour utiliser la version définie dans le fichier visual-application.json de l'application.
    Si la version est déjà déployée, annulez d'abord son déploiement.
  19. Désélectionnez la case Inclure la version d'application dans l'URL.
    Lors du déploiement vers une instance de production, n'incluez pas la version de l'application dans l'URL de l'application déployée.
  20. (Facultatif) Dans Profil d'application, indiquez le profil d'application de production. Laissez ce champ vide pour utiliser le profil par défaut de l'application.

    Votre application visuelle accède aux données de différents serveurs pour les services REST et peut avoir besoin de différents paramètres de sécurité pour différents environnements, tels que le développement et la production. Les profils d'application vous permettent de définir différentes combinaisons de serveurs et de paramètres de sécurité pour chacun de vos environnements, et de les utiliser lors du déploiement de l'application vers un environnement. Cela simplifie la gestion de l'application visuelle à mesure que vous passez du développement à la production. Pour en savoir plus, reportez-vous à A propos des profils d'application.

  21. Afin d'utiliser une base de données nettoyée pour l'application, dans Gestion des données, sélectionnez Utiliser une base de données nettoyée.
  22. Cliquez sur Enregistrer.

Configuration du paramètre de confidentialité d'un travail de production

Marquer un travail comme privé pour restreindre les personnes autorisées à voir ou modifier la configuration d'un travail, ou exécuter son build.

Un travail privé doit être exécuté manuellement. Elle ne sera pas exécutée si un utilisateur non autorisé tente d'exécuter le travail directement, via un déclencheur SCM/périodique ou un pipeline.
  1. Dans le navigateur de gauche, cliquez sur Administration de projet Administration du projet.
  2. Cliquez sur Constructions.
  3. Cliquez sur l'onglet Protection de travail.
  4. Dans la liste des jobs, sélectionnez un job de production.
  5. Sélectionnez l'option Privé.
  6. Dans Utilisateurs autorisés, ajoutez-vous.
    Ensuite, pour ajouter d'autres utilisateurs, sélectionnez-les individuellement ou, sous Groupes, sélectionnez un ou plusieurs groupes d'utilisateurs.
  7. Répétez les étapes 4 à 6 pour le travail de production de déploiement.
  8. Cliquez sur Enregistrer.

Un travail privé affiche une icône Verrouiller Lock dans la liste des travaux sur le côté droit de la page Protection des travaux, dans l'onglet Travaux de la page Constructions et dans les pipelines.

Création et configuration d'un pipeline

Pour vous assurer que le travail de déploiement de production s'exécute automatiquement après le travail de packaging de production, créez un pipeline et définissez la dépendance.

  1. Dans le navigateur de gauche, cliquez sur Constructions Builds.
  2. Cliquez sur l'onglet Pipelines.
  3. Cliquez sur + Créer un pipeline.
  4. Dans la boîte de dialogue Créer un pipeline, dans Nom et Description, entrez un nom unique et une description.
  5. Cliquez sur Créer.
  6. Sur la page Configuration de pipeline, cliquez avec le bouton droit de la souris sur le noeud Démarrer et sélectionnez Ajouter de nouveaux travaux de démarrage.
  7. Cliquez dans le champ Sélectionner de nouveaux travaux en cas de réussite, sélectionnez le travail de package et cliquez sur Enregistrer.
  8. Cliquez avec le bouton droit de la souris sur le travail de packaging et sélectionnez Ajouter, puis Ajouter de nouveaux travaux en cas de succès.
  9. Cliquez dans le champ Sélectionner de nouveaux travaux en cas de réussite, sélectionnez le travail de déploiement, puis cliquez sur Enregistrer.

    Voici un exemple du pipeline finalisé :

  10. Cliquez sur Enregistrer.

Exécuter le pipeline

Lorsque vous êtes prêt à déployer l'application visuelle vers l'instance de production, exécutez le pipeline de production.

  1. Dans le navigateur de gauche, cliquez sur Constructions Builds.
  2. Cliquez sur l'onglet Pipelines.
  3. Sur la ligne du pipeline de développement, cliquez sur le menu Actions Actions et sélectionnez Exécuter le pipeline.

Une fois la création réussie, vous trouverez le lien de l'application déployée dans l'onglet Déploiements de la page Environnements.

Pour afficher le dernier journal de build d'un travail, ouvrez la page Constructions, cliquez sur le nom du travail, puis sur Journal de build.