Créer et configurer un projet à l'aide du modèle d'application visuelle

Lorsque votre instance VB Studio se trouve dans le même domaine d'identité que votre instance Visual Builder, vous pouvez créer un projet basé sur le modèle Visual Application, puis définir quelques paramètres de configuration dans le projet afin qu'il soit prêt pour le développement d'applications visuelles.

Voici un récapitulatif de la création et de la configuration d'un projet VB Studio pour le développement à partir du modèle Visual Application :

Pour effectuer cette action : Voir ceci :
1. Créez un projet. Créer un projet à l'aide du modèle d'application Visual
Remarque

Avant d'essayer de créer un projet, assurez-vous que votre instance VB Studio est autorisée à accéder aux instances Visual Builder connectées à votre compte OCI. Sans cette autorisation, ces instances ne seront pas disponibles pour sélection en tant que cible de déploiement dans votre projet. Reportez-vous à Autorisation de VB Studio d'accéder à Visual Builder et aux instances d'intégration.
2 (Facultatif) Configurez le travail de déploiement afin d'ajouter des informations d'identification pour la connexion à l'instance de développement cible. Configurer le travail de déploiement

Lorsque vous créez un projet à l'aide du modèle Visual Application, un espace de travail configuré pour déployer votre application visuelle vers l'instance de développement Visual Builder via un pipeline de CI/CD est créé. Si vous préférez, vous pouvez désactiver le pipeline d'intégration continue et de déploiement continu et le déployer directement vers l'instance de développement Visual Builder.

Si vous désactivez le pipeline d'intégration continue et de déploiement continu pour le déploiement, ignorez cette étape.

3 (Facultatif) Vérifiez vos informations d'identification en exécutant le pipeline de développement. Exécuter le pipeline manuellement

Si vous désactivez le pipeline d'intégration continue et de déploiement continu pour le déploiement, ignorez cette étape.

4. Visualiser les applications visuelles déployées. Afficher l'application visuelle déployée
5. Ajoutez des membres d'équipe au projet. Ajouter des utilisateurs au projet

Créer un projet à l'aide du modèle d'application Visual

Si vous développez une application visuelle à l'aide d'une instance VB Studio qui se trouve dans le même domaine d'identité que votre instance Visual Builder, vous pouvez démarrer rapidement en basant votre projet sur le modèle de projet Visual Application.

  1. Connectez-vous à VB Studio. Reportez-vous à Accès à VB Studio à partir de la page d'accueil Oracle Cloud.
  2. Sur la page Organisation, cliquez sur + Créer.
  3. Sur la page Détails du projet de l'assistant Nouveau projet, entrez un nom et une description uniques pour le projet.
  4. Dans Sécurité, sélectionnez la confidentialité du projet :
    1. Sélectionnez Privé pour restreindre l'accès aux membres du projet uniquement.

      Cochez la case Repérable pour permettre aux membres de l'organisation qui ne sont pas des administrateurs d'organisation ou des membres de projet de voir des informations de base, telles que le nom et les coordonnées du propriétaire, sur votre projet privé. Les projets privés qui ne sont pas détectables ne seront pas exposés aux non-membres.

    2. Sélectionnez Partagé pour rendre le code, les documents Wiki, les tâches et les builds du projet disponibles pour toutes les personnes de votre organisation.
  5. Dans Langue préférée, indiquez la langue des notifications par courriel que les utilisateurs du projet recevront.
    Vous pouvez modifier la langue d'affichage de l'interface utilisateur dans vos préférences utilisateur.
  6. Cliquez sur Suivant.
  7. Sur la page Modèle de projet, sélectionnez le modèle de projet Application visuelle, puis cliquez sur Suivant.
  8. Sur la page Propriétés de projet, procédez comme suit :
    1. Dans Nom du référentiel Git, modifiez le nom par défaut du référentiel Git, si nécessaire.
    2. Dans Région et Compartiment, sélectionnez la région et le compartiment OCI dans lesquels se trouve votre instance Visual Builder.
    3. Dans Instance de développement VB, si elle n'est pas déjà sélectionnée, sélectionnez l'instance de développement Visual Builder.
      Si vous ne voyez pas l'instance Visual Builder dont vous avez besoin, revenez en arrière et révisez vos sélections pour la région et le compartiment OCI.
    4. Dans Modèle d'application Visual, sélectionnez un modèle d'application Visual disponible sur l'instance de développement sélectionnée.
      Par défaut, VB Studio utilise le modèle Application VB par défaut. Pour sélectionner un autre modèle, cliquez sur Modifier le modèle, sélectionnez le modèle et cliquez sur Utiliser la sélection.
    5. (Facultatif) Si nécessaire, modifiez le nom de votre espace de travail privé dans Nom de l'espace de travail. Par défaut, il s'agit de Workspace1.

      Un espace de travail contient tous les artefacts dont vous avez besoin pour développer des applications visuelles, y compris un clone du référentiel Git de ce projet et du branchement contenant les fichiers source. Pour en savoir plus sur les espaces de travail, reportez-vous à Création d'un espace de travail dans Création d'applications adaptatives avec Visual Builder Studio.

    6. (Facultatif) Dans Nom de branchement de travail, si nécessaire, modifiez le nom de branchement de travail de l'espace de travail. Par défaut, il s'agit de branch1.
      Lorsque le projet est provisionné, la branche main du référentiel Git contient les fichiers de votre application. Lors de la création de l'espace de travail, VB Studio crée une copie de la branche main, la renomme avec le nom indiqué et l'utilise comme branche de travail de l'espace de travail.
    7. Cliquez sur Suivant.
  9. Sur la page Equipe :
    1. Cliquez sur Ajouter des membres et sélectionnez les utilisateurs ou les groupes à ajouter au projet, dans la liste affichée.
    2. Sélectionnez l'appartenance (propriétaire de projet, développeur accès complet, développeur accès limité ou contributeur) que les membres que vous ajoutez auront dans le projet.
      Pour plus d'informations sur chaque appartenance, voir Que sont les appartenances à un projet ?.
    3. Cliquez sur Ajouter.
    4. Répétez les sous-étapes a, b et c pour différents utilisateurs et groupes avec différents types d'appartenance, si nécessaire.
  10. Cliquez sur Terminer.
Une fois le projet provisionné, la page Répertoire de base du projet s'ouvre, dans laquelle vous pouvez voir un récapitulatif des activités de provisionnement du projet, de l'environnement par défaut, de l'espace de travail par défaut et des référentiels Git, Maven et NPM. Consultez le flux d'activités et le champ Environnements pour connaître les erreurs éventuelles.

Lorsque vous créez un projet à l'aide du modèle Visual Application, les artefacts suivants sont créés pour vous :

  • Un référentiel Git, qui contient le code source de l'application visuelle.

    Pour afficher les fichiers du référentiel Git, accédez à la page d'accueil du projet, cliquez sur l'onglet Référentiels, puis sur le nom du référentiel Git :

  • Environnement de développement pointant vers l'instance de développement Visual Builder.

    Dans le navigateur de gauche, cliquez sur Environnements Environnements pour afficher l'environnement de développement :

  • Créez des travaux qui packagent et déploient l'artefact de l'application visuelle vers l'instance de développement Visual Builder.

    Par défaut, les travaux Visual-Application-Package et Visual-Application-Deploy sont créés pour vous. Le travail Visual-Application-Package génère le fichier d'artefact de l'application visuelle. Le travail Visual-Application-Deploy déploie le fichier d'artefact de l'application visuelle vers l'instance de développement Visual Builder.

    Dans le navigateur de gauche, cliquez sur Builds Builds, puis sur l'onglet Jobs pour afficher les travaux de build :

    Pour exécuter des builds du package et déployer des travaux, vous devez d'abord allouer des exécuteurs de build de machine virtuelle et effectuer les configurations de déploiement appropriées. Sans la configuration appropriée ou les exécuteurs de machine virtuelle, les builds ne seront pas exécutés.

  • Pipeline permettant d'exécuter les travaux de build dans une séquence.

    Dans le navigateur de gauche, cliquez sur Constructions Builds, puis sur l'onglet Pipelines. Sur la ligne du pipeline, cliquez sur le menu Actions Actions et sélectionnez Afficher la présentation.

    Si vous préférez contourner le pipeline d'intégration continue et de déploiement continu et le déployer directement sur votre instance Visual Builder, modifiez le paramètre de pipeline d'intégration et de déploiement continus.

  • Espace de travail privé permettant de modifier l'application visuelle dans VB Studio Designer.

    Dans le navigateur de gauche, cliquez sur Espaces de travail Concepteur pour afficher l'espace de travail :

  • Par défaut, le projet utilise le langage de balisage par défaut de l'organisation. Les utilisateurs de votre projet utilisent le langage de balisage pour formater les pages wiki et les commentaires. Si nécessaire, vous pouvez modifier le langage de balisage du projet à partir de la page Administration du projet. Reportez-vous à la section Change a Project's Wiki Markup Language.
  • Un exécuteur de machine virtuelle est créé si ce projet est le premier projet de VB Studio et qu'aucun exécuteur de machine virtuelle de build n'avait existé lors de la création du projet. L'exécuteur de machine virtuelle utilise le modèle d'exécuteur de build Système par défaut OL7 pour Visual Builder. Vous pouvez utiliser cet exécuteur de machine virtuelle pour exécuter des travaux de build qui référencent le modèle Valeur par défaut du système OL7 pour Visual Builder dans le projet en cours et d'autres projets. Pour plus d'informations sur les exécuteurs de machine virtuelle et les modèles d'exécuteur de build, reportez-vous à Exécuteurs de build de machine virtuelle.

    Dans le navigateur de gauche, cliquez sur Organisation Organisation, puis sur l'onglet Exécuteurs de build de machine virtuelle pour afficher l'exécuteur de machine virtuelle.

Configurer le travail de déploiement

Le travail de déploiement déploie l'artefact de build de l'application visuelle vers votre instance de développement Visual Builder. Dans le travail de déploiement, indiquez la version et le profil de l'application, ainsi que les informations d'identification requises pour connecter et déployer l'artefact de build à votre instance de développement Visual Builder.

  1. Dans le navigateur de gauche, cliquez sur Constructions Builds.
  2. Dans l'onglet Travaux, cliquez sur le travail de déploiement.
  3. Cliquez sur Configurer.
  4. Cliquez sur Configurer Builds.
  5. Cliquez sur l'onglet Etapes.
  6. 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).

  7. (Facultatif) Pour remplacer la version par défaut de l'application, indiquez la nouvelle 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.
    Ne désélectionnez pas la case à cocher Inclure la version de l'application dans l'URL.
  8. (Facultatif) Dans Profil d'application, indiquez le profil d'application de développement. 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.

  9. (Facultatif) Pour utiliser la base de données de l'application existante, dans Gestion des données, sélectionnez Conserver les données d'environnement existantes.

    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.

  10. Cliquez sur Enregistrer.

Exécuter le pipeline manuellement

Le pipeline de build de développement s'exécute automatiquement lorsqu'une validation est poussée vers la branche du référentiel Git indiquée dans le travail de packaging.

Si vous voulez exécuter le pipeline manuellement :
  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.

Pour surveiller le pipeline et voir son statut, cliquez sur son nom. Pour afficher le journal de build d'un travail, cliquez sur son nom, puis sur Visualiser le journal.

Si vous voulez exécuter le build d'un travail manuellement, ouvrez la page de détails du travail et cliquez sur Créer maintenant. Vous pouvez surveiller son build sur la page de détails du travail.

Afficher l'application visuelle déployée

Une fois le travail de déploiement exécuté, vous pouvez visualiser les applications déployées dans l'onglet Déploiements de la page Environnements.

  1. Dans le navigateur de gauche, cliquez sur Environnements Environnements.
  2. Sélectionnez l'environnement Visual Builder.
  3. Cliquez sur l'onglet Déploiements.
  4. Si cette option n'est pas activée, cliquez sur le bouton à bascule Applications visuelles.
  5. Si l'instance Visual Builder provient d'un autre domaine d'identité, fournissez ses informations d'identification d'accès.
  6. Développez le nom de l'application pour voir le lien de l'application déployée.
    L'onglet Déploiements affiche les applications déployées à partir du projet en cours. Elle n'affiche pas les applications déployées par d'autres utilisateurs du projet, ni les applications déployées à partir d'autres projets. Voici un exemple :
Si vous souhaitez annuler le déploiement de l'application visuelle déployée, vous pouvez le faire manuellement ou via une configuration de travail. Reportez-vous à Annulation du déploiement d'une application Visual.