Créer et configurer des commandes de production

Vous devez configurer certaines tâches d'assemblage et de déploiement pour pouvoir 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 les tâches de création 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 la tâche d'assemblage 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 la tâche d'emballage de production.
  • Si vous avez configuré la tâche d'ensemble de développement pour remplacer la version de l'application définie dans visual-application.json, obtenez la nouvelle version. Vous en aurez besoin lorsque vous configurerez la tâche d'emballage de production.
  • Lors de la configuration des tâches de création de déploiement, vous indiquez s'il faut inclure la version de l'application dans son URL. Une application visuelle sans la version dans son URL est appelée application Live. 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 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 il 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 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 non déployée et exécutez-la. Vous ne pouvez pas annuler son déploiement manuellement à partir de la page Environnement.
  • Si vous déployez une application sur une URL personnalisée, vous devez configurer la tâche de déploiement pour qu'elle soit déployée dans l'environnement qui héberge l'URL personnalisée. Vous ne pouvez déployer l'application qu'à l'aide de l'authentification d'authentification de base. Vous devez donc vérifier que les données d'identification requises pour vous connecter à l'environnement et le déployer sont correctes.
  • Si vous avez créé un profil d'application pour la production, obtenez son nom. Vous en aurez besoin lorsque vous configurerez la tâche de déploiement en production.

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

La tâche d'assemblage 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 Nouvelle tâche, dans Nom, entrez un nom unique.
  4. Dans Description, entrez la description de la tâche.
  5. Dans Modèle, sélectionnez le modèle OL7 par défaut du système 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 le 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 Ajouter une étape, sélectionnez Application visuelle, puis Ensemble.
  13. Par défaut, les tâches de compilation minifient le code source de l'application avant d'exécuter la compilation. Si vous ne voulez pas réduire les fichiers sources, décochez la case Optimiser l'application.
    La minification est un processus pour 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 rend le transfert de fichiers moins consommatrice de bande passante et de stockage.
  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 source de l'application visuelle. Dans Créer un artefact, spécifiez le nom et le chemin du fichier d'archive 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 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 création de déploiement de production

La tâche de déploiement en production déploie l'artefact de l'application visuelle généré dans la tâche d'assemblage en 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 Nouvelle tâche, dans Nom, entrez un nom unique.
  4. Dans Description, entrez la description de la tâche.
  5. Dans Modèle, sélectionnez le modèle OL7 par défaut du système 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 compilation, sélectionnez Copier les artefacts.
  10. Dans Tâche : De, sélectionnez la tâche d'assemblage de production qui a généré l'artefact de l'application visuelle.
  11. Dans Quelle sous-version, sélectionnez Dernière sous-version 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'emballage 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'assemblage.

    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 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 à cocher 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 de l'application, spécifiez le profil de l'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 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'une tâche de production

Marquez un travail comme étant privé pour limiter les personnes pouvant 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 s'exécutera pas si un utilisateur non autorisé tente d'exécuter la tâche 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éer.
  3. Cliquez sur l'onglet Protection des emplois.
  4. Dans la liste des tâches, sélectionnez une tâche 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.

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

Créer et configurer un pipeline

Pour garantir que la tâche de déploiement en production s'exécute automatiquement après la tâche d'assemblage en 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 Démarrer et sélectionnez Ajouter un nouveau démarrage.
  7. Cliquez dans le champ Sélectionner de nouvelles tâches réussies, sélectionnez la tâche d'assemblage et cliquez sur Enregistrer.
  8. Cliquez avec le bouton droit de la souris sur la tâche d'assemblage et sélectionnez Ajouter, puis Ajouter de nouvelles tâches réussies.
  9. Cliquez dans le champ Sélectionner de nouvelles tâches réussies, sélectionnez la tâche de déploiement, puis cliquez sur Enregistrer.

    Voici un exemple de 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.