Créer et configurer un projet pour le développement

Un projet rassemble toutes les ressources dont vous avez besoin pour développer des logiciels, dans ce cas, un projet pour les applications visuelles.

Une fois que vous avez configuré VB Studio pour développer des applications visuelles, suivez les étapes de ce tableau pour créer un projet vide, ajouter un environnement avec une instance Visual Builder, configurer le travail de déploiement et ajouter des utilisateurs au projet. Lorsque votre instance VB Studio se trouve dans un domaine d'identité différent de celui de votre instance Visual Builder, vous devez également autoriser la connexion à votre instance Visual Builder.

Conseil :

Au lieu de créer un projet vide et de le configurer manuellement (comme décrit ici), vous pouvez utiliser le modèle Visual Application pour créer rapidement un projet avec tout ce dont vous avez besoin pour développer des applications visuelles. Cette option n'est disponible que lorsque votre instance VB Studio se trouve dans le même domaine d'identité que votre instance Visual Builder. Reportez-vous à Création et configuration d'un projet à l'aide du modèle d'application visuelle.
Action Procédure
1. Créez un projet VB Studio vide.
  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, entrez un nom et une description uniques pour le projet.
  4. Dans Sécurité, sélectionnez le paramètre de confidentialité du projet.

    Un projet privé est accessible uniquement aux utilisateurs invités. Les utilisateurs qui ne sont pas invités ne peuvent pas y accéder ni y apporter de modifications. Vous pouvez inviter des utilisateurs après avoir créé le projet.

    Un projet partagé est accessible à tous les utilisateurs de l'organisation. Tout utilisateur peut afficher le code source, créer ou mettre à jour des problèmes, modifier des pages wiki et interagir avec les builds de projet. Cependant, seuls les utilisateurs invités peuvent mettre à jour le code source dans les référentiels Git, créer et exécuter des travaux de build et effectuer des opérations de déploiement.

  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, sélectionnez le modèle Projet vide, puis cliquez sur Suivant.
  8. Sur la page Propriétés, sélectionnez le type d'annotation Wiki, puis cliquez sur Terminer.

Une fois le projet provisionné, la page d'accueil du projet s'ouvre, dans laquelle vous pouvez voir un récapitulatif des activités de provisionnement du projet. Recherchez les erreurs éventuelles dans le flux d'activités.

2. Dans le projet, créez un environnement avec votre instance Visual Builder.
Remarque

Avant d'essayer de créer un environnement, 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 dans votre environnement en tant que cible de déploiement. Reportez-vous à Autorisation de VB Studio d'accéder à Visual Builder et aux instances d'intégration.
  1. Dans le menu de navigation, cliquez sur Environnements Environnements, puis sur + Créer un environnement.
  2. Dans les champs Nom d'environnement et Description, entrez un nom et une description uniques, puis cliquez sur Créer.
  3. Dans l'onglet Instances de service de l'environnement, cliquez sur Ajouter une instance.
  4. Localisez et ajoutez votre instance Visual Builder :
    1. Assurez-vous que le type d'instance est défini sur Visual Builder et que l'option Ajouter une instance à l'aide est définie sur Liste des instances. C'est l'approche privilégiée.
    2. Cliquez sur Modifier les détails OCI en regard de Détails OCI, sélectionnez la région et le compartiment dans lesquels se trouve votre instance Visual Builder, puis cliquez sur Mettre à jour.
    3. Sélectionnez votre instance Visual Builder dans la liste des instances du compartiment sélectionné et cliquez sur Ajouter.

    Si vous ne voyez pas l'instance à ajouter (car elle est connectée à un autre compte OCI), sélectionnez Informations d'identification Visual Builder sous Ajouter une instance à l'aide. Dans URL de base, entrez l'URL de l'instance Visual Builder, mettez à jour le nom d'instance si nécessaire, entrez les informations d'identification d'un utilisateur pouvant accéder à l'instance Visual Builder dans Nom utilisateur et Mot de passe, puis cliquez sur Ajouter. L'utilisation de cette approche ne vous permettra pas de configurer OAuth pour cet environnement dans le travail de build de déploiement, utilisé par l'action Publier dans le concepteur.

  5. Si votre instance cible utilise un domaine d'identité différent de celui de votre instance VB Studio, des jetons OAuth (via des flux OAuth à trois branches) sont utilisés pour sécuriser l'accès par programmation à l'instance. Avant de pouvoir créer des jetons OAuth, vous devez fournir l'autorisation d'acquérir des jetons OAuth. Cliquez sur Autoriser lorsque vous y êtes invité, puis connectez-vous avec les informations d'identification pour vous connecter à l'instance cible et la déployer.

Une fois que vous avez terminé, le flux Activités récentes de la page d'accueil Projet répertorie l'environnement nouvellement créé ainsi que l'instance Visual Builder que vous avez ajoutée.

3. Lorsque les utilisateurs sont prêts, ils peuvent créer un espace de travail dans le projet.
  1. Dans le menu de navigation, cliquez sur Espaces de travail Designer.
  2. Cliquez sur Nouveau et sélectionnez Nouvelle application visuelle.
  3. Dans Nom de l'espace de travail, ajoutez le nom de votre espace de travail.
  4. Dans Environnement de développement, sélectionnez l'environnement que vous avez créé à l'étape précédente.
  5. Dans Modèle d'application visuelle, ne modifiez pas la valeur par défaut (Application VB par défaut).
  6. Dans Référentiel Git, sélectionnez Créer un référentiel, puis entrez un nom de référentiel et un nom de branchement fonctionnel.
4. L'utilisateur qui a créé l'application visuelle devra configurer son travail de déploiement.
  1. Dans le menu de navigation de Visual Builder Studio, cliquez sur Constructions Builds.
  2. Dans l'onglet Travaux, cliquez sur le travail de déploiement.
  3. Cliquez sur Configurer, puis sur l'onglet Etapes.
  4. Dans Instance cible, assurez-vous que l'environnement que vous avez créé à l'étape 2 est sélectionné.
  5. 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).

  6. (Facultatif) Choisissez Utiliser des noms de fichier personnalisés et ajoutez des détails de nom de fichier personnalisé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 Inclure la version d'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.

    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. Pour en savoir plus, reportez-vous à Présentation 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.
5. Ajoutez des utilisateurs au projet. Pour permettre aux membres de votre équipe d'accéder au projet d'application visuelle, invitez-les à rejoindre le projet. Reportez-vous à Ajouter des utilisateurs au projet.