デプロイを管理

このページは Apigee と Apigee ハイブリッドに適用されます。

このドキュメントでは、API デプロイの作成と管理について説明します。API デプロイの概要もご覧ください。デプロイエンティティを作成したら、1 つ以上の API バージョンにリンクできます。

デプロイを作成する

デプロイエンティティは、コンソールまたは REST API で作成できます。

コンソール

新しいデプロイを作成するには:

Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動
[API] をクリックします。
[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
API をクリックして詳細を表示します。
[デプロイ] タブで [デプロイを追加] をクリックします。
[デプロイの作成] フォームで、デプロイの詳細を指定します。
- デプロイ ID: [一意の ID を指定] をクリックし、必要に応じてデプロイの一意の ID を指定します。ID を省略すると、API Hub によって ID が作成されます。ID は 4～500 文字にする必要があります。有効な文字は /[A-Z][a-z][0-9]-/. です。
- デプロイ名: （必須）デプロイの表示名を指定します。
- 説明: デプロイの説明を入力します。
- デプロイタイプ: デプロイのタイプを選択します。使用可能な値はシステム属性で定義されており、[属性を管理] で変更できます。
- リソース URI: （必須）ランタイムリソースの URI を指定します。この URI を使用してリソースを管理できます。たとえば、ランタイムリソースが Apigee API プロキシの場合、このフィールドにはプロキシの管理 UI の URI が設定されます。
- 環境: このデプロイにマッピングされた環境。環境は、システム定義の環境属性にマッピングされます。
- ドキュメント: デプロイのドキュメントへのリンクを入力します。
- SLO: このデプロイの SLO を指定します。これは、SLO のシステム定義属性にマッピングされます。この属性の値は、[属性を管理] で変更できます。
- エンドポイント: （必須）このデプロイリソースが API リクエストをリッスンするエンドポイントを指定します。完全な URI、ホスト名、IP アドレスのリストを指定できます。
- バージョンにリンク: デプロイを 1 つ以上の API バージョンにリンクします。
- ユーザー定義属性: ユーザー定義の Key-Value ペア。ユーザー定義属性は、[属性を管理] で追加できます。
[作成] をクリックします。

REST

Create a deployment API を使用して新しいデプロイを追加するには:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments?deployment_id=DEPLOYMENT_ID"
  -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X POST -H "Content-Type: application/json" \
  '{
    "display-name": DISPLAY_NAME
    }'

次のように置き換えます。

HUB_PROJECT: API Hub のホストプロジェクトの名前。API Hub のプロビジョニング時にホストプロジェクトが選択されました。
HUB_LOCATION: ホストプロジェクトのロケーション。API Hub のプロビジョニング時にこのロケーションが選択されました。
DEPLOYMENT_ID: 省略可。デプロイの識別子。指定しない場合、システムで生成された ID が使用されます。名前は 4～500 文字の文字列にする必要があり、有効な文字は /[a-z][A-Z][0-9]-_/. です。
DISPLAY_NAME: （必須）デプロイの表示名。任意の名前を付けることができます。
オプションの属性: 必須の表示名に加えて、オプションの属性とエンティティをデプロイに追加できます。これらの追加項目については、REST API リファレンスのデプロイリソースの説明をご覧ください。

API バージョンにデプロイをリンクする

1 つのバージョンに 1 つ以上のデプロイがリンクされている場合があります。このセクションでは、デプロイをバージョンにリンクする方法について説明します。デプロイをバージョンにリンクする場合は、バージョンの作成時にリンクします。デプロイを既存のバージョンにリンクする場合は、既存のバージョンを編集します。API バージョンを作成するおよびバージョンを編集するをご覧ください。

デプロイを新しいバージョンまたは既存のバージョンにリンクするには、デプロイがすでに存在している必要があります。デプロイを作成するをご覧ください。

コンソール

バージョンにデプロイを追加するには:

Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動
[API] をクリックします。
[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
API を選択します。
[バージョン] 表で、編集するバージョンを見つけます。
バージョン行の右側にある [アクション] メニューで [編集] を選択するか、バージョンを選択して詳細ページの [バージョンを編集] をクリックします。
[デプロイにリンク] で、バージョンにリンクするデプロイを 1 つ以上選択し、[OK] をクリックします。
[保存] をクリックします。

REST

バージョンにデプロイを追加する例:

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/apis/API_NAME/versions/VERSION_ID"
  -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X PATCH -H "Content-Type: application/json" \
  '{
    "deployments": "DEPLOYMENTS"
  }'

次のように置き換えます。

HUB_PROJECT: API Hub のホストプロジェクトの名前。API Hub のプロビジョニング時にホストプロジェクトが選択されました。
HUB_LOCATION: ホストプロジェクトの場所。API Hub のプロビジョニング時に選択した場所です。
API_NAME: 編集するバージョンを含む API の名前。
VERSION_ID: 編集するバージョンの一意の ID。
DEPLOYMENTS: 1 つ以上のデプロイの完全修飾リソース名。例: "projects/myproject/locations/us-central1/deployments/mydeployment-1, projects/myproject/locations/us-central1/deployments/mydeployment-2"

デプロイを一覧表示する

このセクションでは、デプロイを一覧表示する方法について説明します。ある特定の API のすべてのバージョンに関連付けられたデプロイすべてを一覧表示できるほか、特定のバージョンに関連付けられたデプロイすべてを一覧表示することもできます。

コンソール

UI でデプロイを一覧表示するには:

Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動
[API] をクリックします。
[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
API をクリックして詳細を表示します。
[デプロイ] タブを選択して、API に関連付けられているデプロイすべてを一覧表示します。
バージョンに関連付けられているデプロイを表示する場合は、[バージョン] タブでそのバージョンを選択します。

REST

すべてのデプロイを一覧表示するには、List deployments API を使用します。

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments"
        -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X GET -H "Content-Type: application/json"

次のように置き換えます。

HUB_PROJECT: API Hub のホストプロジェクトの名前。このホストプロジェクトは API Hub のプロビジョニング時に選択されたものです。
HUB_LOCATION: ホストプロジェクトの場所。API Hub のプロビジョニング時に選択した場所です。

デプロイの詳細を取得する

このセクションでは、API デプロイの詳細を取得する方法について説明します。

コンソール

デプロイの詳細を表示するには:

Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動
[API] をクリックします。
[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
API をクリックして詳細を表示します。
[デプロイ] タブを選択して、API に関連付けられているデプロイすべてを一覧表示します。
デプロイを選択して、その詳細ページを表示します。

REST

デプロイの詳細を表示するには、Get deployment details API を使用します。

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
    -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X GET -H "Content-Type: application/json"

次のように置き換えます。

HUB_PROJECT: API Hub のホストプロジェクトの名前。このホストプロジェクトは API Hub のプロビジョニング時に選択されたものです。
HUB_LOCATION: ホストプロジェクトの場所。API Hub のプロビジョニング時に選択した場所です。
DEPLOYMENT_ID: デプロイの一意の ID。

API デプロイを削除する

このセクションでは、API デプロイを削除する方法について説明します。

コンソール

UI を使用して API リソースを削除するには:

Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動
[API] をクリックします。
[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
API をクリックして詳細を表示します。
[デプロイ] タブを選択して、API に関連付けられているデプロイすべてを一覧表示します。
削除するデプロイを見つけます。
デプロイの [操作] メニューで [削除] を選択します。

REST

API Hub から API リソースを削除するには、デプロイの削除 API を使用します。

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
    -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X DELETE -H "Content-Type: application/json"

次のように置き換えます。

HUB_PROJECT: API Hub のホストプロジェクトの名前。このホストプロジェクトは API Hub のプロビジョニング時に選択されたものです。
HUB_LOCATION: ホストプロジェクトの場所。API Hub のプロビジョニング時に選択した場所です。
DEPLOYMENT_ID: 削除するデプロイの一意の ID。

デプロイメントを編集する

このセクションでは、デプロイを編集する方法について説明します。

コンソール

Google Cloud コンソールで、[API Hub] ページに移動します。
[API Hub] に移動
[API] をクリックします。
[フィルタ] を使用して、API のリストをフィルタするキーワードを指定します。必要に応じて、[検索] を使用して API を探します。
API をクリックして詳細を表示します。
[デプロイ] タブを選択して、API に関連付けられているデプロイすべてを一覧表示します。
編集するデプロイを見つけます。
デプロイの [操作] メニューで [編集] を選択するか、デプロイをクリックして、[デプロイの詳細] パネルで [デプロイの編集] をクリックします。

REST

デプロイを編集するには、Patch deployment API を使用します。

curl "https://apihub.googleapis.com/v1/projects/HUB_PROJECT/locations/HUB_LOCATION/deployments/DEPLOYMENT_ID"
      -H "Authorization: Bearer: $(gcloud auth print-access-token)" -X PATCH -H "Content-Type: application/json"
      '{
        DEPLOYMENT_ATTRIBUTES
      {'

次のように置き換えます。

HUB_PROJECT: API Hub のホストプロジェクトの名前。このホストプロジェクトは API Hub のプロビジョニング時に選択されたものです。
HUB_LOCATION: ホストプロジェクトの場所。API Hub のプロビジョニング時に選択した場所です。
DEPLOYMENT_ID: 編集するデプロイの一意の ID。
DEPLOYMENT_ATTRIBUTES: リクエスト本文内の変更する属性をアタッチします。編集可能な属性については、REST API リファレンスのデプロイリソースの説明をご覧ください。