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

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, 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é n'est accessible qu'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 consulter le code source, créer ou mettre à jour des problèmes, modifier des pages wiki et interagir avec les builds de projet. Toutefois, 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 et affiche un récapitulatif des activités de provisionnement du projet. Vérifiez si le flux d'activités comporte des erreurs.

1. Dans le menu de navigation, cliquez sur Environnements , puis sur + Créer un environnement.
2. Dans Nom de l'environnement et Description, entrez un nom unique et sa description, 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 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é, puis 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 de l'instance si nécessaire, entrez les informations d'identification d'un utilisateur qui peut accéder à l'instance Visual Builder dans Nom utilisateur et Mot de passe, puis cliquez sur Ajouter. Notez cependant que 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 (en fonction de la configuration).

5. Si votre instance cible utilise un domaine d'identité différent de celui de votre instance VB Studio, les jetons OAuth (via des flux OAuth à trois branches) sont utilisés pour sécuriser l'accès par programmation à l'instance. Pour pouvoir créer des jetons OAuth, vous devez fournir l'autorisation d'acquérir des jetons OAuth. Lorsque vous y êtes invité, cliquez sur Autoriser, 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 du projet répertorie l'environnement nouvellement créé avec l'instance Visual Builder que vous avez ajoutée.

1. Dans le menu de recherche, cliquez sur Espaces de travail .
2. Cliquez sur Nouveau et sélectionnez Nouvelle application visuelle.
3. Dans Nom de l'espace de travail, ajoutez un nom à l'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 visuel, 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 de branchement de travail.

Lorsqu'une application visuelle est créée via un nouvel espace de travail, elle est configurée pour être déployée directement vers l'instance de développement Visual Builder, sans l'utilisation d'un pipeline d'intégration continue et de déploiement continu. Si nécessaire, vous pouvez plutôt activer le pipeline d'intégration continue et de déploiement continu pour le branchement cible vers lequel vous fusionnez.

Si vous n'utilisez pas de pipelines de CI/CD pour le déploiement, ignorez cette étape.

1. Dans le menu de navigation de Visual Builder Studio, cliquez sur Builds .
2. Dans l'onglet Travaux, cliquez sur le travail de déploiement. Lorsque vous créez un espace de travail, les travaux de packaging et de déploiement sont automatiquement créés et prennent le nom de votre référentiel. (Elles seront toutefois désactivées jusqu'à ce que vous les activiez.)
3. Cliquez sur Configurer, puis sur l'onglet Etapes.
4. Dans Instance cible, vérifiez 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 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).

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

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