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

プロジェクトは、ソフトウェアの開発に必要なすべてのリソース(この場合はビジュアル・アプリケーション用のプロジェクト)を収集します。

ビジュアル・アプリケーションを開発するためのVB Studioの設定が完了したら、この表のステップに従って空のプロジェクトを作成し、Visual Builderインスタンスを含む環境を追加し、デプロイメント・ジョブを構成して、ユーザーをプロジェクトに追加します。VB StudioインスタンスがVisual Builderインスタンスとは異なるアイデンティティ・ドメインにある場合は、さらにVisual Builderインスタンスへの接続を認可する必要があります。

ヒント:

空のプロジェクトを作成して手動で設定するのではなく(ここで説明)、ビジュアル・アプリケーション・テンプレートを使用して、ビジュアル・アプリケーションの開発に必要なすべてのものを含むプロジェクトをすばやく作成できます。このオプションは、VB StudioインスタンスがVisual Builderインスタンスと同じアイデンティティ・ドメインにある場合にのみ使用できます。ビジュアル・アプリケーション・テンプレートを使用したプロジェクトの作成および設定を参照してください。
アクション 方法
1. 空のVB Studioプロジェクトを作成します。
  1. VB Studioにサインインします。Oracle Cloudホーム・ページからVB Studioへのアクセスを参照してください。
  2. 組織ページで、「+作成」をクリックします。
  3. 「プロジェクト詳細」ページで、プロジェクトの一意の名前と説明を入力します。
  4. 「セキュリティ」で、プロジェクトのプライバシ設定を選択します。

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

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

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

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

2. プロジェクトで、Visual Builderインスタンスを使用して環境を作成します。
ノート

環境を作成する前に、VB Studioインスタンスが、OCIアカウントに接続されているVisual Builderインスタンスにアクセスする権限があることを確認してください。この認可がない場合、これらのインスタンスはデプロイメント・ターゲットとして環境内で選択できなくなります。Visual Builderおよび統合インスタンスにアクセスするためのVB Studioの認可を参照してください。
  1. ナビゲーション・メニューで、「環境」 環境「+環境の作成」の順にクリックします。
  2. 「環境名」および「説明」に一意の名前と説明を入力し、「作成」をクリックします。
  3. 環境の「サービス・インスタンス」タブで、「インスタンスの追加」をクリックします。
  4. Visual Builderインスタンスを見つけて追加します。
    1. 「インスタンス・タイプ」が「ビジュアル・ビルダー」に設定され、「インスタンスの追加に使用」が「インスタンス・リスト」に設定されていることを確認します。これは優先アプローチです。
    2. 「OCIの詳細」の横にあるOCI詳細の変更をクリックし、Visual Builderインスタンスが存在するリージョンおよびコンパートメントを選択して、「更新」をクリックします。
    3. 選択したコンパートメントのインスタンス・リストからVisual Builderインスタンスを選択し、「追加」をクリックします。

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

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

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

3. ユーザーが準備ができたら、プロジェクトにワークスペースを作成できます。
  1. 「ワークスペース」 設計者をクリックします。
  2. 「新規」をクリックし、「新規ビジュアル・アプリケーション」を選択します。
  3. 「ワークスペース名」で、ワークスペースの名前を追加します。
  4. 「開発環境」で、前のステップで作成した環境を選択します。
  5. 「ビジュアル・アプリケーション・テンプレート」で、デフォルト(デフォルトVBアプリケーション)を変更しないでください。
  6. 「Gitリポジトリ」で、「新規リポジトリの作成」を選択し、リポジトリ名と作業ブランチ名を入力します。
4. ビジュアル・アプリケーションを作成したユーザーは、デプロイメント・ジョブを構成する必要があります。
  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が推奨される認可タイプです。OAuth接続の設定で問題が発生した場合のみ、Basic認証を使用します。Basic認証を使用するには、「基本の使用」を選択し、「ユーザー名」および「パスワード」でVisual Builderインスタンスにアクセスできるユーザーの資格証明を入力します。

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

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

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

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

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

  9. (オプション)既存のアプリケーションのデータベースを使用するには、「データ管理」「既存の環境データの保持」を選択します。アプリケーションにクリーン・データベースを使用するには、「データ管理」「クリーン・データベースの使用」を選択します。
  10. 「保存」をクリックします。
5. プロジェクトにユーザーを追加します。 チーム・メンバーがビジュアル・アプリケーション・プロジェクトにアクセスできるようにするには、プロジェクトに参加するよう招待します。プロジェクトへのユーザーの追加を参照してください。