機械翻訳について

アプリケーション・デプロイメント・ページの探索

アプリケーションの「Deployments」ページを使用して、アプリケーションの再デプロイ、環境変数およびサービス・バインディングの構成、ならびにデプロイメント履歴の表示ができます。

次の表に、アプリケーションのデプロイメント・ページに表示される重要な情報を示します。

要素 説明

デプロイメント

デプロイされたアプリケーションに関する次の情報を表示します:

  • デプロイされたアプリケーションの現行バージョン

  • 前回のデプロイメントの日時スタンプ

  • アーカイブ・ファイルのサイズ

  • アーカイブ・ファイルの名前

  • アプリケーション・ソースはアプリケーションをデプロイしたアカウントです。

  • コミットIDは、アプリケーションがパッケージ化されたときにmanifest.jsonファイルで割り当てられる文字列です。

  • ビルド番号は、manifest.jsonファイルで割り当てられる文字列です。

  • リリース・ノートは、デプロイされたときのアプリケーションに関するノートです。

「アプリケーションの再デプロイ」を参照してください。

ランタイム

アプリケーションとランタイム・バージョンを起動するコマンドを表示します。

トポロジ

アプリケーション・インスタンスの数とインスタンスごとのメモリー量をギガ・バイト単位で表示します。

Service Bindings

アプリケーションが接続するその他のOracle Cloudサービスのリストを表示します。 「サービス・バインディングの管理」を参照してください。

Environment Variables

アプリケーションで利用できるすべての環境変数のリストを表示します。 「システム変数を隠す」をクリックして、リストからシステム変数を削除します。 「環境変数の構成」を参照してください。

Deployment History

アプリケーションのデプロイメント履歴をリストします。

アプリケーションmanifest.jsonファイルまたはdeployment.jsonファイルをダウンロードするには、メニューをクリックします。

アプリケーションの再デプロイ

アプリケーションを変更した場合は、アプリケーション・コンソールのデプロイメント・ページから再デプロイできます。 この手順では、アプリケーションが以前にデプロイされていることを前提としています。

  1. 「Service」コンソールを開きます。
  2. 「Applications」表で、アプリケーション名をクリックします。
  3. 左側のペインで、「デプロイメント」をクリックします。
  4. 「更新」をクリックします。
  5. 「ブラウズ」をクリックして、新しいアーカイブ、manifest.json、またはdeployment.jsonファイルをアップロードします。
  6. ファイルを選択し、「Open」をクリックします。
  7. 必要に応じて、「起動コマンド」「バージョン」「インスタンス」、または「メモリー(GB)」の値を編集します。
  8. 必要に応じてサービス・バインディングや環境変数を追加します。
  9. 「編集を適用」をクリックして変更を保存し、アプリケーションを再起動します。
  10. プロンプトが表示されたら、「ローリング再起動」または「Concurrent再起動」を選択し、「再起動」をクリックします。

サービス・バインディングの管理

サービス・バインディングは、他のサブスクライブされたOracle Cloudサービスへの接続を提供します。

現在、サービス・バインディングを使用して、Oracle Application Container Cloud ServiceからOracle Database Cloud ServiceOracle MySQL Cloud ServiceOracle Java Cloud ServiceOracle Event Hub Cloud ServiceOracle Data Hub Cloud Service、またはアプリケーション・キャッシュに接続できます。

サービス・バインディングを追加する手順:

  1. 「サービス・コンソール」を開きます。

  2. 「アプリケーション」tableで、アプリケーション名をクリックします。

  3. 「アプリケーション・コンソール」で、「デプロイメント」ページをクリックします。

  4. 「Deployments」ページの「Service Bindings」セクションで、「Add」をクリックします。

  5. 「サービス・バインディングの追加」ダイアログ・ボックスで、次の値を指定します:

    • サービス・タイプ - サービスのタイプ: Oracle Java Cloud ServiceOracle Database Cloud ServiceOracle MySQL Cloud ServiceOracle Event Hub Cloud ServiceOracle Data Hub Cloud Service、またはキャッシング・サービスです。 Oracle Event Hub Cloud Serviceの場合、プラットフォーム・レベルでクラスタにアクセスするには、トピックを公開またはサブスクライブするOEHCS、またはOHEPCSを指定します。

    • 「サービス名」 - サービスの名前、Oracle Java Cloud Serviceインスタンスの名前、Oracle Database Cloud Serviceデータベース、Oracle MySQL Cloud Serviceデータベース、Oracle Event Hub Cloud Serviceトピックまたはクラスタ、Oracle Data Hub Cloud Serviceインスタンス、またはキャッシュ・サービス。

    • 「ユーザー名」 - サービスにアクセスするために使用されるユーザー名。 詳細はステップの後の注意を参照してください。

    • 「パスワード」 - ユーザー名のパスワード。 詳細はステップの後の注意を参照してください。

  6. 「保存」をクリックします。

  7. 変更を適用するには、ページ上部の「Apply Edits」をクリックします。 プロンプトが表示されたら、「Rolling Restart」または「Concurrent Restart」を選択し、「Apply」をクリックします。

注意:

「ユーザー名」「パスワード」は、自動的にターゲット・サービスに対する認証に使用されません。 値は、アプリケーションがアクセスできるSERVICE_USER_NAME およびSERVICE_USER_PASSWORD環境変数に格納されます。 ターゲット・サービスで認証が必要な場合は、アプリケーションで処理する必要があります。 ターゲット・サービスで認証が必要ない場合は、Oracle Java Cloud ServiceOracle Database Cloud Service、またはOracle MySQL Cloud Serviceのユーザー名とパスワードは省略できませんが、任意の値を指定できます。 Oracle Event Hub Cloud Serviceの場合、「ユーザー名」フィールドと「パスワード」フィールドはオプションです。 キャッシュ・サービスの場合、「ユーザー名」および「パスワード」フィールドはグレー表示され、使用されません。

サービス・バインディングがリストに追加され、その環境変数が自動的に「Environment Variables」リストに追加されます。 Oracle Java Cloud Serviceの場合、これらの変数の名前はプレフィクスJAAS_で始まります。 Oracle Database Cloud Serviceの場合、プレフィクスはDBAAS_です。 Oracle MySQL Cloud Serviceの場合、プレフィクスはMYSQLCS_です。 Oracle Event Hub Cloud Serviceの場合、プレフィクスはOEHCS_またはOEHPCS_です。 Oracle Data Hub Cloud Serviceの場合、プレフィクスはDHCS_です。 キャッシュ・サービスの場合、CACHING_INTERNAL_CACHE_URLという名前の変数が1つあります。 「環境変数の構成」を参照してください。

注意:

Oracle MySQL Cloud Serviceサービス・バインディングから生成される環境変数はすべて大文字ですが、大文字と小文字が混在してコンソールに表示されます。 コードが大文字の名前を参照していることを確認します。

サービス・バインディングを編集するには、「編集」アイコンをクリックし、サービス・バインディングの値を編集 - 編集ダイアログ・ボックスを開き、「保存」をクリックします。 サービス・バインディングを削除するには、「削除」iconをクリックします。

代替案として、deployment.jsonファイルでサービス・バインディングを定義できます。 『Oracle Application Container Cloud Serviceの開発』メタデータ・ファイルの作成に関する項を参照してください。

「Oracle Application Container Cloud Serviceの開発」「サービス・バインディング」を参照してください。

環境変数の構成

環境変数は、アプリケーションが実行されるランタイム環境の詳細を提供するもので、実行中のアプリケーションからアクセス可能です。

アプリケーションを作成するときには、あらかじめ定義された環境変数を使用できます。 アプリケーションに合わせてサービス・バインディングを作成すると、関連する環境変数が作成されます。 「Application」コンソールの「Deployments」ページから、追加の環境変数を作成して、すべての環境変数を管理できます。

アプリケーションの作成時に、次の事前定義済の環境変数を使用できます。

  • $HOSTNAME - このアプリケーションのホスト名が生成されました。

  • $PORT - ほとんどのアプリケーション・タイプがロード・バランサからのトラフィックを監視するポート。

  • $APP_HOME -デプロイされたアプリケーションのアーカイブ・ファイルが抽出されたディレクトリ。

  • $ORA_APP_NAME - 作成時にユーザーが指定したアプリケーションの名前。

  • $ORA_APP_PUBLIC_URL - アプリケーションのパブリックURL。

  • $ORA_INSTANCE_NAME - web.1またはweb.2など、特定のアプリケーション・インスタンスの名前。

  • $ORA_PORT - $PORT環境変数と同じ値。 アプリケーションは、$PORTまたは$ORA_PORTを使用してポートを読み取ることができます。

サブスクライブされたOracle Cloudサービスにサービス・バインディングを追加した場合は、さらに事前定義された環境変数を使用できるため、デプロイされたアプリケーションはOracle Cloudサービスと対話できます。 「サービス・バインディングの管理」を参照してください。

注意:

Oracle MySQL Cloud Serviceサービス・バインディングから生成される環境変数はすべて大文字ですが、大文字と小文字が混在してコンソールに表示されます。 コードが大文字の名前を参照していることを確認してください。

また、「Application」コンソールの「Deployments」ページまたはdeployment.jsonファイルに、独自の環境変数をキーと値のペアとして定義できます。 deployment.jsonファイルの詳細は、『Oracle Application Container Cloud Serviceの開発』メタデータ・ファイルの作成に関する項を参照してください。

サービス・バインディングまたはREST APIを使用できないサービスに接続する場合のベスト・プラクティスは、接続情報の環境変数を作成することです。 たとえば、Oracle Cloud Infrastructure Compute Classic内の仮想マシン(VM)に接続するには、VMのIPアドレスとポートの環境変数を作成します。

環境変数は他の環境変数を参照することができます。 たとえば、Oracle Database Cloud Serviceデータベースへの接続にサービス・バインディングと環境変数がありますが、デフォルトのプラガブル・データベース(PDB)を使用しないとします。 あなたのPDBのサービス名がMYPDB.identity-domain.oraclecloud.comだとします。 MYPDB_CONNECT_DESCRIPTORという名前の環境変数に独自の接続記述子を作成して、データベースのホスト名とポートを参照するが、PDBを含めることができます:

$DBAAS_LISTENER_HOST_NAME:$DBAAS_LISTENER_PORT/MYPDB.identity-domain.oraclecloud.com
「Application」コンソールの「Deployments」ページに環境変数を追加する手順は、次のとおりです。
  1. 「サービス・コンソール」を開きます。
  2. 「アプリケーション」表で、アプリケーション名をクリックします。
  3. 「アプリケーション・コンソール」で、「デプロイメント」ページをクリックします。
  4. 「デプロイメント」ページの「環境変数」セクションで、「追加」をクリックします。
  5. 「環境変数を追加」ダイアログ・ボックスの「名前」フィールドに変数名を入力し、「値」フィールドに値を入力します。 環境変数を保護されたものとしてマークするには、「表示」チェックボックスをオフにします。 保護された環境変数の値は、ユーザー・インタフェース上に表示されません。
  6. 「保存」をクリックします。
変数を編集するには、「Edit」アイコンをクリックして、「Edit Environment Variable」ダイアログで値を編集し、「Save」をクリックします。

変数を削除するには、「Delete」アイコンをクリックします。

変更を適用するには、ページ上部の「Apply Edits」をクリックします。 「Rolling Restart」または「Concurrent Restart」を選択し、「Restart」をクリックします。