開発のためのプロジェクトの作成および設定

1. VB Studioにサインインします。Oracle Cloudホーム・ページからVB Studioへのアクセスを参照してください。
2. 「組織」ページで、「+作成」をクリックします。
3. 「プロジェクト詳細」ページで、プロジェクトの一意の名前と説明を入力します。
4. 「セキュリティ」で、プロジェクトのプライバシ設定を選択します。

   プライベート・プロジェクトには、招待されたユーザーのみがアクセスできます。招待されていないユーザーは、それにアクセスしたり、変更することはできません。プロジェクトの作成後にユーザーを招待できます。

   共有プロジェクトは、組織のすべてのユーザーがアクセスできます。組織のすべてのユーザーが、ソース・コードの表示、問題の作成または更新、wikiページの編集およびプロジェクト・ビルドとの対話を実行できます。ただし、招待されたユーザーのみが、Gitリポジトリのソース・コードの更新、ビルド・ジョブの作成と実行、およびデプロイメント操作を実行できます。

5. 「優先言語」で、プロジェクト・ユーザーが受信するEメール通知の言語を指定します。ユーザー・プリファレンスでユーザー・インタフェースが表示される言語を変更できます。
6. 「次へ」をクリックします。
7. 「テンプレート」ページで、「空のプロジェクト」テンプレートを選択し、「次へ」をクリックします。
8. 「プロパティ」ページで、Wikiマークアップ・タイプを選択し、「終了」をクリックします。

プロジェクトのプロビジョニング後、プロジェクト・ホーム・ページが開き、プロジェクトのプロビジョニング・アクティビティのサマリーを確認できます。エラーがないかアクティビティ・フィードをレビューします。

1. ナビゲーション・メニューで、「環境」をクリックし、「+環境の作成」をクリックします。
2. 「環境名」および「説明」で、一意の名前と説明を入力し、「作成」をクリックします。
3. 環境の「サービス・インスタンス」タブで、「インスタンスの追加」をクリックします。
4. Visual Builderインスタンスを見つけて追加します。
   1. 「インスタンス・タイプ」が「ビジュアル・ビルダー」に設定され、「インスタンスの追加使用」が「インスタンス・リスト」に設定されていることを確認します。これは優先アプローチです。
   2. 「OCIの詳細」の横にあるをクリックし、Visual Builderインスタンスがあるリージョンおよびコンパートメントを選択して、「更新」をクリックします。
   3. 選択したコンパートメントのインスタンス・リストからVisual Builderインスタンスを選択し、「追加」をクリックします。

   追加するインスタンス(別のOCIアカウントに接続されているため)が表示されない場合は、「インスタンスの追加」で「Visual Builder資格証明」を選択します。「ベースURL」に、Visual BuilderインスタンスのURLを入力し、必要に応じて「インスタンス名」を更新し、Visual Builderインスタンスにアクセスできるユーザーの資格証明を「ユーザー名」および「パスワード」に入力し、「追加」をクリックします。ただし、この方法を使用すると、Designerのパブリッシュ・アクションで使用されるデプロイメント・ビルド・ジョブでこの環境にOAuthを設定することはできません(設定によって異なります)。

5. ターゲット・インスタンスがVB Studioインスタンスとは異なるアイデンティティ・ドメインを使用する場合、OAuthトークン(3-legged OAuthフロー経由)を使用して、インスタンスへのプログラムによるアクセスを保護します。OAuthトークンを作成する前に、OAuthトークンを取得するための認可を指定する必要があります。プロンプトが表示されたら「認可」をクリックし、資格証明でサインインして接続し、ターゲット・インスタンスにデプロイします。

完了すると、「プロジェクト・ホーム」ページの「最近のアクティビティ」フィードに、新しく作成した環境と、追加したVisual Builderインスタンスがリストされます。

1. ナビゲーション・メニューから、「ワークスペース」 をクリックします。
2. 「新規」をクリックし、「新規ビジュアル・アプリケーション」を選択します。
3. 「ワークスペース名」で、ワークスペースの名前を追加します。
4. 「開発環境」で、前のステップで作成した環境を選択します。
5. 「ビジュアル・アプリケーション・テンプレート」で、デフォルト(デフォルトVBアプリケーション)は変更しないでください。
6. 「Gitリポジトリ」で、「新規リポジトリの作成」を選択し、リポジトリ名と作業ブランチ名を入力します。

ビジュアル・アプリケーションが新しいワークスペースを介して作成されると、CI/CDパイプラインを使用せずに、開発Visual Builderインスタンスに直接デプロイするように構成されます。必要に応じて、かわりにマージ先のターゲット・ブランチのCI/CDパイプラインを有効化できます。

CI/CDパイプラインをデプロイメントに使用していない場合は、このステップをスキップします。

1. Visual Builder Studioのナビゲーション・メニューで、「ビルド」 をクリックします。
2. 「ジョブ」タブで、デプロイメント・ジョブをクリックします。ワークスペースを作成すると、パッケージング・ジョブとデプロイ・ジョブが自動的に作成され、リポジトリの名前が使用されます。(ただし、有効にするまで無効になります。)
3. 「構成」をクリックし、「ステップ」タブをクリックします。
4. 「ターゲット・インスタンス」で、ステップ2で作成した環境が選択されていることを確認します。

5. 「認可」セクションで、このビルド・ステップを実行する認可タイプを指定します。「OAuthを使用」がデフォルトで選択されていると、Authorization is requiredメッセージが表示され、このビルド・ステップでは、環境のVisual Builderインスタンスに対するOAuthリクエストを処理するための1回かぎりの認可が必要であることを示します。「認可」をクリックし、Visual Builderインスタンスにアクセスするための資格証明を入力します。ジョブを手動で実行し、プロンプトが表示されたら資格証明を入力することもできます。

   いずれの場合も、初期構成時にOAuth接続を承認することをお薦めします。このステップをスキップすると、デザイナから変更を公開できなくなり、変更のデプロイを試行する前に必要な認可を完了する必要があります。

   承認されると、Authorization has been providedメッセージが表示されます。

   ノート
   
   OAuthが推奨される認可タイプです。Basic認証は、OAuth接続の設定で問題が発生した場合にのみ使用します。Basic認証を使用するには、「Basicの使用」を選択し、Visual Builderインスタンスにアクセスできるユーザーの資格証明を「ユーザー名」および「パスワード」に入力します。

   OAuthトークン(アクセスおよびリフレッシュ)は、通常の使用中に循環されます。リフレッシュ・トークンは、ユーザーがターゲット・インスタンスにアクセスするたびにアクセス・トークンを取得するために使用されます。このリフレッシュ・トークンは通常、7日間有効です。(トークンの有効期限はIDCSリソース・アプリケーションで設定され、セキュリティ要件によって異なる場合があります。) ユーザーが7日以内にターゲット・インスタンスで認証すると、アクティブなリフレッシュ・トークンによって新しいアクセス・トークンと新しいリフレッシュ・トークンが生成されます。リフレッシュ・トークンが有効であるかぎり、このサイクルは無期限に続行されます。リフレッシュ・トークンが長時間非アクティブ状態(休暇中など)で期限切れになった場合は、「認可の更新」をクリックします(または、ジョブを手動で実行すると、期限切れのOAuthトークンを承認するよう求められます)。

6. (オプション)「カスタム・ファイル名の使用」を選択し、カスタム・ファイル名の詳細を追加します。
7. (オプション)アプリケーションのデフォルト・バージョンを上書きするには、「アプリケーション・バージョン」で新しいバージョンを指定します。アプリケーションのvisual-application.jsonファイルに定義されているバージョンを使用する場合は、空のままにします。

   「URLにアプリケーション・バージョンを含めます」チェック・ボックスの選択を解除しないでください。

8. (オプション)「アプリケーション・プロファイル」で、開発アプリケーション・プロファイルを指定します。アプリケーションのデフォルト・プロファイルを使用するには、空のままにします。

   アプリケーション・プロファイルを使用すると、環境ごとに異なるサーバー設定とセキュリティ設定の組合せを定義し、アプリケーションを環境にデプロイする際に使用できます。さらに学習するには、アプリケーション・プロファイルとはを参照してください

9. (オプション)既存のアプリケーションのデータベースを使用するには、「データ管理」で「既存の環境データの保持」を選択します。アプリケーションにクリーン・データベースを使用するには、「データ管理」で「クリーン・データベースの使用」を選択します。
10. 「保存」をクリックします。