Créer et configurer des travaux de fabrication en 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 le 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 des travaux de build de production, notez les points suivants :

Dans le travail de packaging 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 de conditionnement de production.
Si vous avez configuré le travail de packaging de développement pour é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 conditionnement 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 Live. En général, vous déployez une application active vers 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 de l'instance de production. Elle 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 précédemment déployée, configurez un travail de build 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 le déployer vers l'environnement hébergeant l'URL personnalisée. Vous ne pouvez déployer l'application qu'à l'aide de l'authentification d'authentification de base. Vous devrez donc vérifier que les informations 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 lorsque vous configurerez le travail de déploiement de production.

Créer un travail de création de packages de production

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

Dans le navigateur de gauche, cliquez sur Builds .
Dans l'onglet Travaux, cliquez sur + Créer un travail.
Dans la boîte de dialogue Nouveau travail, dans Nom, entrez un nom unique.
Dans Description, entrez la description du travail.
Dans Modèle, sélectionnez le modèle OL7 par défaut du système pour Visual Builder.
Cliquez sur Créer.
Cliquez sur Configurer .
Cliquez sur l'onglet Git.
Dans la liste Ajouter un Git, sélectionnez Git.
Dans Référentiel, sélectionnez le référentiel Git. Dans Branche ou balise, sélectionnez la branche de production.
Cliquez sur l'onglet Etapes.
Dans Ajouter une étape, sélectionnez Application visuelle, puis Package.
Par défaut, les travaux de build minifient le code source de l'application avant d'exécuter le build. Si vous ne voulez pas réduire les fichiers source, désélectionnez la case Optimiser l'application.
La minimisation est un processus qui permet 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.
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.
Cliquez sur l'onglet Après la création.
Dans Ajouter après l'action de build, sélectionnez Archiver d'artefacts.
Dans Fichiers à archiver, entrez le nom de l'artefact de build. Vous pouvez également utiliser des caractères génériques. Par exemple, *.zip.
Si vous souhaitez ignorer les anciens artefacts du build, cliquez sur Paramètres . Dans l'onglet Général, cochez la case Rejeter les anciens builds et indiquez les options de rejet.
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 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 effectuer son déploiement.

Dans le navigateur de gauche, cliquez sur Builds .
Dans l'onglet Travaux, cliquez sur + Créer un travail.
Dans la boîte de dialogue Nouveau travail, dans Nom, entrez un nom unique.
Dans Description, entrez la description du travail.
Dans Modèle, sélectionnez le modèle OL7 par défaut du système pour Visual Builder.
Cliquez sur Créer.
Cliquez sur Configurer .
Cliquez sur l'onglet Avant la création.
Dans Ajouter avant l'action de build, sélectionnez Copier les artefacts.
Dans Travail d'origine, sélectionnez le travail de packaging de production qui a généré l'artefact de l'application visuelle.
Dans Quel build ?, sélectionnez Dernier build réussi.
Laissez les autres champs avec leurs valeurs par défaut ou vides.
Cliquez sur l'onglet Etapes.
Dans Ajouter une étape, sélectionnez Application visuelle, puis Déployer.
Dans Instance cible, sélectionnez l'instance de production Visual Builder.
Dans la section Autorisation, indiquez le type d'autorisation pour exécuter cette étape de paramétrage. Lorsque l'option Utiliser OAuth est sélectionnée par défaut, le message Authorization is required apparaît, indiquant que cette étape de build nécessite 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 tous les 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 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

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 de base, puis entrez les informations d'identification d'un utilisateur qui peut 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 pendant 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).
Dans le travail de packaging 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 indiqués dans le travail de packaging.
Si vous n'avez pas modifié les noms de fichier, utilisez l'option par défaut.
(Facultatif) Si vous avez configuré le travail de déploiement de développement pour remplacer la version par défaut de l'application, indiquez 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 d'abord son déploiement.
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.
(Facultatif) Dans Profil d'application, indiquez 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. 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 lorsque vous passez du développement à la production. Pour en savoir plus, reportez-vous à A propos des profils d'application.
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.
Cliquez sur Enregistrer.

Configuration du paramètre de confidentialité d'une tâche de production

Marquez un travail comme privé pour limiter les personnes autorisées à voir ou modifier la configuration d'un travail ou à exécuter sa création.

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.

Dans le navigateur de gauche, cliquez sur Administration de projet .
Cliquez sur Builds.
Cliquez sur l'onglet Protection des travaux.
Dans la liste des travaux, sélectionnez un travail de production.
Sélectionnez l'option Privé.
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.
Répétez les étapes 4 à 6 pour le travail de production de déploiement.
Cliquez sur Enregistrer.

Un travail privé affiche une icône Verrouiller dans la liste des travaux à droite de la page Protection des travaux, dans l'onglet Travaux de la page Builds et dans les pipelines.

Création et configuration d'un pipeline

Pour garantir 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.

Dans le navigateur de gauche, cliquez sur Builds .
Cliquez sur l'onglet Pipelines.
Cliquez sur + Créer un pipeline.
Dans la boîte de dialogue Créer un pipeline, entrez un nom et une description uniques dans Nom et Description.
Cliquez sur Créer.
Sur la page Configuration de pipeline, cliquez avec le bouton droit de la souris sur le noeud Démarrer et sélectionnez les travaux Ajouter un nouveau démarrage.
Cliquez dans le champ Sélectionner nouveau sur les travaux réussis, sélectionnez le travail de packaging et cliquez sur Enregistrer.
Cliquez avec le bouton droit de la souris sur le travail de packaging et sélectionnez Ajouter, puis Ajouter des travaux réussis.
Cliquez dans le champ Sélectionner nouveau sur les travaux réussis, sélectionnez le travail de déploiement, puis cliquez sur Enregistrer.

Voici un exemple de pipeline finalisé :

Description de l'image visualapp-prod-pipeline3.png
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.

Dans le navigateur de gauche, cliquez sur Builds .
Cliquez sur l'onglet Pipelines.
Sur la ligne du pipeline de développement, cliquez sur le menu 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 Builds, cliquez sur le nom du travail, puis sur Créer un journal.