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

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 à développer des applications visuelles.

Voici un résumé 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, procédez comme suit : Voir ce qui suit :
1. Crée un projet. Créer un projet à l'aide du modèle d'application Visual
Remarque

Avant de tenter 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 à 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. Affichez les applications visuelles déployées. Affichage de l'application visuelle déployée
5. Ajouter 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 rapidement commencer en basant votre projet sur le modèle de projet Visual Application.

  1. Se connecter à 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 limiter 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 du projet de voir les informations de base, telles que le nom et les informations de contact 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 du projet, les documents Wiki, les tâches et les builds disponibles pour tous les membres 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 dans laquelle l'interface utilisateur apparaît 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 du projet :
    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 où se trouve votre instance Visual Builder.
    3. Dans Instance VB de développement, 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 visuel, sélectionnez un modèle d'application visuel 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) Dans Nom de l'espace de travail, si nécessaire, modifiez le nom de votre espace de travail privé. Par défaut, il est 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 la branche de travail, si nécessaire, modifiez le nom de la branche de travail de l'espace de travail. Par défaut, il est 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'adhésion (propriétaire du projet, accès complet du développeur, accès limité du développeur ou contributeur) que les membres que vous ajoutez auront dans le projet.
      Pour plus d'informations sur chaque adhésion, voir Qu'est-ce qu'une adhésion à un projet ?.
    3. Cliquez sur Ajouter.
    4. Répétez les sous-étapes a, b et c pour les différents utilisateurs et groupes avec différents types d'adhésion, si nécessaire.
  10. Cliquez sur Terminer.
Une fois le projet provisionné, la page Répertoire de base du projet s'ouvre. Elle affiche 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 la zone Environnements pour toute erreur.

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 Développement :

  • Créez des travaux qui regroupent 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 Travaux pour afficher les travaux de build :

    Pour exécuter les builds du package et les travaux de déploiement, vous devez d'abord allouer les 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 Builds 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 la langue d'annotation 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 la langue d'annotation du projet à partir de la page Administration du projet. Reportez-vous à Modification du langage de balisage wiki d'un projet.
  • 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 OL7 par défaut du système pour Visual Builder. Vous pouvez utiliser cet exécuteur de machine virtuelle pour exécuter des travaux de build qui référencent également 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 Builds 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 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).

  7. (Facultatif) Pour remplacer la version par défaut de l'application, indiquez la nouvelle version dans Version de l'application. Laissez-le vide pour utiliser la version définie dans le fichier visual-application.json de l'application.
    Ne désélectionnez pas la case Inclure la version d'application dans l'URL.
  8. (Facultatif) Dans Profil d'application, indiquez le profil d'application de développement. 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.

  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.

    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.

  10. Cliquez sur Enregistrer.

Exécuter le pipeline manuellement

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

Pour exécuter le pipeline manuellement :
  1. Dans le navigateur de gauche, cliquez sur Builds 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 le statut de chaque travail, 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 manuellement le build d'un travail, ouvrez la page de détails du travail et cliquez sur Créer maintenant. Vous pouvez surveiller sa création sur la page de détails du travail.

Affichage de 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 son lien.
    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 visuelle.