Créer et configurer des tâches de fabrication de production

Vous devez configurer des tâches d'emballage et de déploiement avant de déployer des applications visuelles dans votre instance de production Visual Builder. Cette rubrique explique comment procéder.

Conseil :

Si vous le souhaitez, VB Studio peut créer et activer les travaux de compilation 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 et de développement en continu. Vous pouvez ensuite modifier les tâches de compilation nouvellement créées si nécessaire (voir les instructions ci-dessous pour des étapes de configuration supplémentaires). Par exemple, dans la tâche 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 votre instance de production.

Avant de configurer des tâches de production, notez les points suivants :

  • Dans le travail d'emballage de production, utilisez la branche de production du référentiel Git pour générer des artefacts de production.
  • Dans le travail d'emballage 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 lors de la configuration de la tâche d'emballage de production.
  • Si vous avez configuré la tâche d'emballage de développement pour remplacer la version de l'application définie dans visual-application.json, obtenez la nouvelle version. Vous en aurez besoin lors de la configuration de la tâche d'emballage de production.
  • Lors de la configuration des tâches de création de déploiement, vous spécifiez 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 Live. En général, vous déployez une application en direct 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 remplace la dernière version déployée par la nouvelle.

    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-la d'abord, sinon la compilation du déploiement échoue. Pour annuler le déploiement d'une version d'application visuelle précédemment déployée, configurez une tâche de compilation dont le déploiement a été annulé et exécutez-la. Vous ne pouvez pas l'annuler manuellement dans la page Environnements.
  • Si vous déployez une application sur une URL personnalisée, vous devez configurer la tâche de déploiement à déployer dans l'environnement hébergeant l'URL personnalisée. Vous ne pouvez déployer l'application qu'à l'aide de l'authentification de base. Vous devez donc vérifier que les données d'identification requises pour la connexion et le déploiement dans l'environnement sont correctes.
  • Si vous avez créé un profil d'application pour la production, obtenez son nom. Vous en aurez besoin lors de la configuration de la tâche de déploiement en production.

Créer une tâche de création d'ensembles de production

La tâche d'emballage de production génère un artefact d'application visuel prêt à être déployé.

  1. Dans le navigateur de gauche, cliquez sur Builds (Créer) Compilations.
  2. Dans l'onglet Tâches, cliquez sur + Créer une tâche.
  3. Dans la boîte de dialogue New Job (Nouveau travail), dans Name (Nom), entrez un nom unique.
  4. Dans Description, entrez la description de l'emploi.
  5. Dans Modèle, sélectionnez le modèle Par défaut du système OL7 pour Visual Builder.
  6. Cliquez sur Créer.
  7. Cliquez sur Configurer Compilations.
  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 marqueur, sélectionnez la branche de production.
  11. Cliquez sur l'onglet Étapes.
  12. Dans Add Step (Ajouter une étape), sélectionnez Visual Application (Application visuelle), puis Package (Ensemble).
  13. Par défaut, les tâches de compilation réduisent le code source de l'application avant d'exécuter la compilation. Si vous ne voulez pas réduire la taille des fichiers sources, désélectionnez la case Optimiser l'application.
    La minimisation est un processus permettant de supprimer les caractères inutiles (tels que les espaces vides, les nouvelles lignes et les commentaires) du code source et de réduire la taille des fichiers, ce qui réduit la consommation de bande passante et de stockage des fichiers.
  14. Pour 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, spécifiez le nom et le chemin du fichier d'archive de la source d'application visuelle. Dans Créer un artefact, spécifiez le nom et le chemin du fichier d'archives de l'artefact de compilation.

    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 une action après la création, sélectionnez Utilitaire d'archivage d'artefacts.
  17. Dans Fichiers à archiver, entrez le nom de l'artefact de compilation. Vous pouvez également utiliser des caractères génériques. Par exemple, *.zip.
  18. Pour abandonner les anciens artefacts de la compilation, cliquez sur Paramètres l'icône Gear. Dans l'onglet Général, cochez la case Abandonner les anciennes versions et spécifiez les options d'abandon.
  19. Cliquez sur Enregistrer.

Créer une tâche de compilation de déploiement de production

La tâche de déploiement de production déploie l'artefact de l'application visuelle qui a été généré dans la tâche d'emballage de production vers l'instance de production Visual Builder. Avant de créer la tâche, obtenez les données 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 Builds (Créer) Compilations.
  2. Dans l'onglet Tâches, cliquez sur + Créer une tâche.
  3. Dans la boîte de dialogue New Job (Nouveau travail), dans Name (Nom), entrez un nom unique.
  4. Dans Description, entrez la description de l'emploi.
  5. Dans Modèle, sélectionnez le modèle Par défaut du système OL7 pour Visual Builder.
  6. Cliquez sur Créer.
  7. Cliquez sur Configurer Compilations.
  8. Cliquez sur l'onglet Avant la création.
  9. Dans Ajouter avant l'action de création, sélectionnez Copier les artefacts.
  10. Dans Du travail, sélectionnez le travail d'assemblage de production qui a généré l'artefact de l'application visuelle.
  11. Dans Quelle compilation, sélectionnez Dernière compilation réussie.
  12. Laissez les autres champs avec leurs valeurs par défaut ou vides.
  13. Cliquez sur l'onglet Étapes.
  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, spécifiez le type d'autorisation pour exécuter cette étape de compilation. Avec l'option Utiliser OAuth sélectionnée par défaut, vous verrez le message Authorization is required indiquant que cette étape de compilation a besoin d'une autorisation ponctuelle pour traiter les demandes OAuth à l'instance Visual Builder de votre environnement. Cliquez sur Autoriser et entrez les données d'identification pour accéder à votre instance Visual Builder; vous pouvez également exécuter la tâche manuellement et entrer les données d'identification à l'invite.

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

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

    Note

    OAuth est le type d'autorisation recommandé. 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 données d'identification d'un utilisateur qui peut accéder à l'instance Visual Builder dans Nom d'utilisateur et Mot de passe.

    Les jetons OAuth (accès et actualisation) sont cycliques lors d'une utilisation régulière. Un jeton d'actualisation est utilisé pour obtenir un jeton d'accès lorsqu'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 ressources 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 en vacances), cliquez sur Renew Authorization (Renouveler l'autorisation) (ou exécutez la tâche manuellement. Vous êtes donc invité à autoriser les jetons OAuth expirés).

  17. Dans la tâche d'assemblage 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 que vous avez spécifiés dans la tâche d'emballage.

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

  18. (Facultatif) Si vous avez configuré la tâche de déploiement de développement pour remplacer la version par défaut de l'application, spécifiez la même version dans Version de l'application. Laissez-le 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-la d'abord.
  19. Désélectionnez la case Inclure la version de l'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, spécifiez le profil d'application de production. Laissez-le 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 nécessiter des paramètres de sécurité différents pour différents environnements, tels que le développement et la production. À l'aide des profils d'application, vous pouvez définir différentes combinaisons de serveurs et de paramètres de sécurité pour chacun de vos environnements, et les utiliser lors du déploiement de l'application dans un environnement. Cela simplifie la gestion de l'application visuelle au fur et à mesure que vous passez du développement à la production. Pour en savoir plus, voir À propos des profils d'application.

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

Configurer le paramètre de confidentialité d'un travail de production

Marquer un travail comme étant privé pour restreindre les utilisateurs qui peuvent voir ou modifier la configuration d'un travail, ou exécuter sa compilation.

Une tâche privée doit être exécutée manuellement. Il ne sera pas exécuté si un utilisateur non autorisé tente d'exécuter le travail directement, au moyen d'un déclencheur SCM/périodique ou d'un pipeline.
  1. Dans le navigateur de gauche, cliquez sur Project Administration (Administration de projet) Administration du projet.
  2. Cliquez sur Créations.
  3. Cliquez sur l'onglet Protection des tâches.
  4. Dans la liste des tâches, sélectionnez une tâche de production.
  5. Sélectionnez l'option Privé.
  6. Dans Authorized Users (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.

Une tâche privée affiche une icône Verrouiller Verrouiller dans la liste des tâches à droite de la page Protection des emplois, dans l'onglet Tâches de la page Constructions et dans les pipelines.

Créer et configurer un pipeline

Pour vous assurer que la tâche de déploiement de production s'exécute automatiquement après la tâche d'emballage de production, créez un pipeline et définissez la dépendance.

  1. Dans le navigateur de gauche, cliquez sur Builds (Créer) Compilations.
  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 et une description uniques.
  5. Cliquez sur Créer.
  6. Dans la page Configuration de pipeline, cliquez avec le bouton droit de la souris sur le noeud Start (Démarrer) et sélectionnez Add New Start (Ajouter un nouveau démarrage).
  7. Cliquez dans le champ Sélectionner une nouvelle tâche réussie, sélectionnez la tâche d'emballage et cliquez sur Enregistrer.
  8. Cliquez avec le bouton droit de la souris sur la tâche d'assemblage et sélectionnez Add (Ajouter), puis Add New On Success Jobs (Ajouter de nouvelles tâches réussies).
  9. Cliquez dans le champ Sélectionner une nouvelle tâche réussie, sélectionnez la tâche de déploiement et 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 dans l'instance de production, exécutez le pipeline de production.

  1. Dans le navigateur de gauche, cliquez sur Builds (Créer) Compilations.
  2. Cliquez sur l'onglet Pipelines.
  3. Dans la rangée du pipeline de développement, cliquez sur le menu Actions Actions et sélectionnez Exécuter le pipeline.

Après une compilation réussie, vous trouverez le lien de l'application déployée dans l'onglet Déploiements de la page Environnements.

Pour voir le journal de compilation le plus récent d'une tâche, ouvrez la page Créations, cliquez sur le nom de la tâche, puis cliquez sur Créer un journal.