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

1. Connectez-vous à VB Studio. Voir Accéder à VB Studio à partir de la page d'accueil d'Oracle Cloud.
2. Dans la page Organisation, cliquez sur + Créer.
3. Dans 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 ou y apporter des 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 des versions 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 tâches de compilation et effectuer des opérations de déploiement.

5. Dans Langue préférée, spécifiez la langue des avis 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. Dans la page Modèle, sélectionnez le modèle Empty Project (Projet vide), puis cliquez sur Next (Suivant).
8. Dans la page Propriétés, sélectionnez le type de balisage wiki, puis cliquez sur Terminer.

Une fois le projet provisionné, la page d'accueil du projet s'ouvre et affiche un sommaire des activités de provisionnement du projet. Consultez le flux des activités pour détecter toute erreur.

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 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 réglé à Visual Builder et que l'option Ajouter une instance à l'aide de est réglée à Liste d'instances. C'est l'approche privilégiée.
   2. Cliquez sur à côté de Détails OCI, sélectionnez la région et le compartiment où 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 Données d'identification Visual Builder sous Ajouter une instance à l'aide de. In Base URL, enter the Visual Builder instance's URL; update the Instance Name if needed; enter the credentials of a user who can access the Visual Builder instance in Username and Password; and click Add. Notez cependant que l'utilisation de cette approche ne vous permettra pas de configurer OAuth pour cet environnement dans la tâche de création de déploiement, utilisée par l'action Publier dans le concepteur (selon la configuration).

5. Si votre instance cible utilise un domaine d'identité différent de celui de votre instance VB Studio, des jetons OAuth (au moyen de flux OAuth à trois branches) sont utilisés pour sécuriser l'accès par programmation à l'instance. Avant de créer des jetons OAuth, vous devez fournir l'autorisation d'acquérir des jetons OAuth. Cliquez sur Autoriser à l'invite, puis connectez-vous avec les données 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éé ainsi que l'instance Visual Builder que vous avez ajoutée.

1. Dans le menu de navigation, cliquez sur Espaces de travail .
2. Cliquez sur New (Nouvelle) et sélectionnez New Visual Application (Nouvelle application visuelle).
3. Dans Nom de l'espace de travail, ajoutez un nom pour 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 Git Repository (Référentiel Git), sélectionnez Create new repository (Créer un référentiel) et entrez un nom de référentiel et un nom de branche de travail.

Lorsqu'une application visuelle est créée au moyen d'un nouvel espace de travail, elle est configurée pour déployer directement l'instance Visual Builder de développement, sans utiliser de pipeline d'intégration et de développement en continu. Si nécessaire, vous pouvez plutôt activer le pipeline d'intégration continue/développement continu pour la branche cible vers laquelle vous fusionnez.

Si vous n'utilisez pas de pipelines d'intégration et de développement en continu pour le déploiement, ignorez cette étape.

1. Dans le menu de navigation de Visual Builder Studio, cliquez sur Créations .
2. Dans l'onglet Tâches, cliquez sur la tâche de déploiement. Lorsque vous créez un espace de travail, les tâches d'assemblage et de déploiement sont automatiquement créées et prennent le nom de votre référentiel. (Ils seront désactivés, cependant, jusqu'à ce que vous les activiez.)
3. Cliquez sur Configurer, puis sur l'onglet Étapes.
4. Dans Instance cible, assurez-vous que l'environnement que vous avez créé à l'étape 2 est sélectionné.

5. 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 Visual Builder de votre environnement. Cliquez sur Autoriser et entrez les données d'identification pour accéder à votre instance Visual Builder; 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 Visual Builder dans Nom d'utilisateur et Mot de passe.

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

6. (Facultatif) Sélectionnez Utiliser des noms de fichier personnalisés et ajoutez des détails sur les noms de fichier personnalisés.
7. (Facultatif) Pour remplacer la version par défaut de l'application, spécifiez 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 à cocher Inclure la version de l'application dans l'URL.

8. (Facultatif) Dans Profil d'application, spécifiez le profil de l'application de développement. Laissez-le vide pour utiliser le profil par défaut de l'application.

   À l'aide des profils d'application, vous pouvez définir différentes combinaisons de serveurs et de paramètres de sécurité pour chacun de vos environnements, et les utiliser lors du déploiement de l'application dans un environnement. Pour en savoir plus, voir À quoi servent les 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.