Voici certaines choses que vous devez savoir avant de configurer et d'exécuter des tâches de compilation et des pipelines :

• Assurez-vous que les instances source et cible ont la même version, avec les mêmes correctifs standard et ponctuels appliqués aux deux environnements.
• 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 allez configurer la tâche d'emballage de la production pour qu'elle utilise la même version.

Le travail d'assemblage génère un artefact d'extension prêt à être déployé dans l'instance de production.

1. Dans le navigateur de gauche, cliquez sur Builds (Créer) .
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 .
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 Extension d'application, puis Ensemble.
13. Par défaut, l'étape d'assemblage réduit 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'extension.

    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.

    Note
    
    Lorsque vous désélectionnez la case à cocher Optimiser l'extension, cet avertissement s'affiche : Optimisation non sélectionnée. L'assemblage sans optimisation peut entraîner des problèmes de performance. Évitez donc de le faire sauf si vous êtes en cours de débogage ou de dépannage.
14. (Facultatif) Pour modifier le nom du fichier d'artefact, dans Créer un artefact, entrez le nouveau nom. La meilleure pratique consiste à conserver la valeur par défaut, extension.vx, mais vous pouvez la modifier.
    Si vous la modifiez, vous devez également utiliser le nouveau nom dans le champ Fichiers à archiver (étape 18) ainsi que dans le champ Créer un artefact de la tâche de déploiement. Voir Créer la tâche de création de déploiement de production.
15. (Facultatif) Si vous avez configuré la tâche d'ensemble de développement pour remplacer la version par défaut de l'extension définie dans le fichier visual-application.json, spécifiez la même version dans Version d'extension.
16. Cliquez sur l'onglet Après la création dans la fenêtre Configuration des tâches.
17. Dans Ajouter une action après la création, sélectionnez Archivage d'artefacts.
18. Dans Fichiers à archiver, entrez le nom de l'artefact de compilation.

    Vous pouvez utiliser des caractères génériques. Par exemple, *.vx. Assurez-vous d'inclure le chemin de l'artefact de création d'extension d'application.

    Si vous avez entré une valeur dans le champ Répertoire cible dans Copier les artefacts pour la tâche de déploiement, elle est considérée comme un sous-répertoire de l'espace de travail et doit faire partie du chemin de l'artefact dans le champ Créer un artefact.

19. Si vous voulez abandonner les anciens artefacts de la compilation, cliquez sur Paramètres . Dans l'onglet Général, cochez la case Abandonner les anciennes versions et spécifiez les options d'abandon.
20. Cliquez sur Enregistrer.

La tâche de déploiement déploie l'artefact de l'extension généré dans la tâche d'emballage vers l'instance de production de l'application Oracle Cloud. Avant de créer la tâche, assurez-vous de disposer des données d'identification que VB Studio peut utiliser pour accéder à l'instance PROD de l'application Oracle Cloud.

1. Dans le navigateur de gauche, cliquez sur Builds (Créer) .
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 .
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 qui a généré l'artefact de l'extension.
11. Dans Quelle sous-version, sélectionnez l'une des options suivantes :
    • Dernière compilation réussie (par défaut)
    • Construire pour toujours
    • Sous-version en amont de cette instance de pipeline
    • Spécifié par permalien
    • Construction spécifique
    • Spécifié par le paramètre de compilation

    Selon ce que vous sélectionnez, vous pouvez être invité à sélectionner le permalien, la compilation ou le paramètre de compilation que vous souhaitez utiliser.
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 Extension d'application, puis Déployer.

    Cette image présente la page Déployer la tâche de compilation partiellement remplie.
    
    Description de l'illustration oracle-deploy-build-step.png
    

15. Dans Instance cible, sélectionnez l'environnement avec l'instance de production de l'application Oracle Cloud.
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 Oracle Cloud Applications de votre environnement. Cliquez sur Autoriser et entrez les données d'identification pour accéder à votre instance Oracle Cloud Applications. 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 Oracle Cloud Applications dans Nom d'utilisateur et Mot de passe. Ces données d'identification doivent être celles d'un utilisateur local, et non d'une identité fédérée, et ne doivent pas nécessiter d'authentification multifacteur.

    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).

    Le champ Créer un artefact doit afficher le même nom d'artefact que celui utilisé à l'étape de compilation de l'ensemble. Confirmez cette valeur, en particulier si le travail d'emballage a utilisé un nom d'artefact autre que le nom par défaut, extension.vx.
17. Cliquez sur Enregistrer.

Pour restreindre l'accès, le responsable du projet peut marquer un travail comme étant privé. Les utilisateurs qui n'ont pas accès peuvent voir la tâche de compilation dans la page Aperçu des tâches, mais ils ne peuvent pas voir la page Détails de la tâche ni voir les détails de la compilation; ils ne peuvent pas non plus voir ou modifier la configuration de la tâche, ni supprimer/activer/désactiver la tâche de compilation. En outre, le responsable du projet peut utiliser un modèle Glob défini dans une règle pour protéger toute tâche dont le nom correspond au modèle spécifié.

1. Dans le navigateur de gauche, cliquez sur Project Administration (Administration de projet) .
2. Sélectionnez la vignette Créer.
3. Sélectionnez l'onglet Protection des emplois.

   La page Job Protection s'affiche.

   
   
   Description de l'illustration job-protection-page-initial.png
   

4. Dans le panneau Rechercher les règles par, situé au-dessus de la liste des tâches/règles, sélectionnez l'un des boutons radio suivants :
   • Sélectionnez Nom de la tâche pour sélectionner une tâche dans la liste.

     Si votre projet a de nombreux emplois, vous pouvez avoir de la difficulté à trouver l'emploi spécifique que vous souhaitez protéger. Utilisez la barre de la tâche de filtre pour localiser rapidement la tâche à laquelle vous voulez ajouter les paramètres restreints.

     Si une tâche de la liste des tâches à gauche comporte une icône de verrouillage à côté de celle-ci, elle a déjà été protégée. Les restrictions d'une tâche protégée peuvent toujours être modifiées, supprimées ou la liste des utilisateurs et groupes autorisés peut toujours être modifiée.

     La boîte de dialogue Protection des emplois s'affiche.

     
     
     Description de l'illustration job-protection-open.png
     

     Lorsqu'une tâche n'est pas directement protégée mais est protégée par une règle à la place, un message d'information tel que le suivant affiche les règles, <ExampleRegex05> dans ce cas, qui protègent la tâche spécifique :

     This job is protected by the following glob pattern rules matching this job name: <ExampleRegex05>

   • Sélectionnez Modèle GLOB pour spécifier une chaîne correspondant au nom de la tâche.

     C'est ce que vous verrez si aucune règle n'a encore été définie.

     
     
     Description de l'illustration job-protection-page-glob-pattern-selected.png
     

     La syntaxe glob peut être utilisée pour spécifier le comportement de correspondance de modèle. Ces caractères génériques peuvent être utilisés dans les modèles globaux : *, **,?, [], {} et \.

     Sélectionnez une règle de protection existante dans la liste ou cliquez sur + Règle pour afficher la boîte de dialogue Nouvelle règle de protection et en créer une nouvelle.

     La boîte de dialogue Protection Rule s'affiche.
     
     Description de l'illustration protection-rule-dialog-populated.png
     Ici, nous avons entré un nom (Règle de test) et un modèle Glob (test*) et nous sommes sur le point d'appuyer sur Créer pour créer une nouvelle règle de protection d'emploi.

5. Cochez la case PRIVÉ.
   C'est ce que vous voyez après avoir sélectionné l'option Private pour un travail.

   
   
   Description de l'illustration job-protection-private.png
   

   Lorsque cette option est sélectionnée, seuls les utilisateurs et groupes autorisés peuvent voir la page Détails de la tâche, la modifier ou l'exécuter manuellement. Si la tâche est déclenchée dans un pipeline par un utilisateur ou un groupe non autorisé, ou si elle est déclenchée par SCM ou un temporisateur, elle ne sera pas lancée.

   C'est ce que vous voyez après avoir sélectionné l'option Private pour une règle de protection.

   
   
   Description de l'illustration job-protection-rule-private.png
   

6. Cliquez dans le champ Utilisateurs/groupes autorisés pour afficher une boîte de dialogue qui répertorie les groupes et les utilisateurs du projet que vous pouvez sélectionner.

   Sous Utilisateurs, vous pouvez voir une liste aplanie de tous les utilisateurs qui sont membres du ou des groupes, ainsi que ceux qui ont été ajoutés individuellement. Par exemple, les membres du groupe dev (Clara Coder, Don Developer et Tina Testsuite) apparaissent dans la liste Utilisateurs, avec Alex Admin, qui a été ajouté individuellement. Dans la liste, sélectionnez un ou plusieurs groupes et/ou utilisateurs. N'oubliez pas de vous ajouter.

   
   
   Description de l'illustration allowed-groups-and-users.png
   

   C'est ce que vous verriez pour la tâche myProtectedJob après avoir sélectionné Alex Admin en tant qu'utilisateur autorisé.

   
   
   Description de l'illustration job-protection-private-authorized-user.png
   

   C'est ce que vous voyez pour la règle de protection Règle de test après avoir sélectionné Alex Admin en tant qu'utilisateur autorisé.

   
   
   Description de l'illustration job-protection-rule-authorized-user.png
   

7. Cochez les cases pour permettre aux membres du projet de démarrer manuellement des travaux privés et/ou d'autoriser les validations et les déclencheurs à démarrer automatiquement des travaux privés :

   • Cochez la case Autoriser n'importe quel membre du projet à démarrer manuellement cette tâche privée pour permettre à n'importe quel membre du projet, et pas seulement aux utilisateurs autorisés, de démarrer manuellement la tâche.

     Ce que vous verrez après avoir coché la case Autoriser un membre du projet à démarrer manuellement cette tâche privée pour la tâche myProtectedJob.

     
     
     Description de l'illustration job-protection-private-both-checkboxes-selected.png
     

     Notez que lorsque vous cochez la première case, VB Studio sélectionne automatiquement la deuxième case, ce qui permet aux validations et aux déclencheurs de démarrer le travail privé, puis la grise. Avec ce paramètre, seuls les utilisateurs et groupes autorisés peuvent voir la page Détails de la tâche ou modifier la tâche, mais n'importe quel membre du projet peut démarrer et exécuter la tâche. En outre, les validations ou les déclencheurs SCM démarrent et exécutent automatiquement le travail.

     Ce que vous verrez après avoir coché la case Autoriser un membre du projet à démarrer manuellement cette tâche privée pour la règle de protection Règle de test.

     
     
     Description de l'illustration job-protection-page-both-check-boxes.png
     

   • Cochez seulement la case Autoriser les validations et les déclencheurs à démarrer cette tâche privée si vous voulez que les validations et les déclencheurs SCM puissent exécuter automatiquement cette tâche.

     
     
     Description de l'illustration job-protection-private-allow-commits-and-triggers.png
     

     Lorsque cette case est cochée, les déclencheurs périodiques exécutent n'importe quelle tâche ou pipeline, y compris les tâches privées définies pour autoriser les validations et les déclencheurs à démarrer la tâche privée. Toutefois, si un pipeline inclut une tâche privée avec cette option sélectionnée et qu'un utilisateur non autorisé tente d'exécuter le pipeline manuellement, la tâche privée ne s'exécutera pas, mais des déclencheurs périodiques et des validations SCM le seront.

     Laissez la case décochée si vous ne voulez pas que le travail soit démarré lorsqu'il est déclenché par une validation ou un temporisateur SCM.

     Note
     
     

     Meilleure pratique :

     Si vous utilisez la case à cocher pour permettre à la compilation protégée d'être déclenchée par une validation SCM, vous devez protéger la branche à laquelle la tâche de compilation est liée. Si vous ne le faites pas, n'importe qui peut déclencher la compilation protégée en effectuant une validation pour la déclencher.

     C'est ce que vous pouvez voir si vous avez sélectionné Autoriser les validations et les déclencheurs à démarrer une tâche correspondant à ce modèle global pour la règle de test.

     
     
     Description de l'illustration job-protection-page-allow-commits-and-triggers.png
     

8. Cliquez sur Enregistrer.

   Le flux de données d'activités affiche toutes les modifications apportées au statut de protection d'une tâche, telles que la modification de la protection d'une tâche de public à privé, ou privée à public, ou la modification d'une tâche privée pour autoriser les validations et les déclencheurs.