始める前に
このハイブリッドのインストール プロセスで説明する手順では、次の 1 つ以上を使用します。
- Google Cloud コンソール
- Apigee ハイブリッド UI
gcloudコマンドライン
環境変数
コマンドラインを使用して実行する手順では、ユーザーが作成した環境変数を利用します。ターミナル ウィンドウが切断された場合、環境変数は保存されません。
以降の手順では、次のような環境変数を使用します。
Linux / macOS
export PROJECT_ID="your_project_id"export ORG_NAME=$PROJECT_IDexport ORG_DISPLAY_NAME="org_friendly_name"export ORGANIZATION_DESCRIPTION="org_description_text"export ANALYTICS_REGION="analytics_region"export RUNTIMETYPE=HYBRIDexport ENV_NAME="environment_name"export ENV_DISPLAY_NAME="env_friendly_name"export ENV_DESCRIPTION="env_description_text"export DOMAIN="example.com"export ENV_GROUP="environment-group-name"export CLUSTER_NAME="cluster_name"export CLUSTER_LOCATION="cluster_region"
スペースが含まれる変数名は、二重引用符で囲む必要があります。次に例を示します。
export ORGANIZATION_DESCRIPTION="My example organization number 1"
Windows
set PROJECT_ID="your_project_id"set ORG_NAME=$PROJECT_IDset ORG_DISPLAY_NAME="org_friendly_name"set ORGANIZATION_DESCRIPTION="org_description_text"set ANALYTICS_REGION="analytics_region"set RUNTIMETYPE=HYBRIDset ENV_NAME="environment_name"set ENV_DISPLAY_NAME="env_friendly_name"set ENV_DESCRIPTION="env_description_text"set DOMAIN="example.com"set ENV_GROUP="environment-group-name"set CLUSTER_NAME="cluster_name"set CLUSTER_LOCATION="cluster_region"
スペースが含まれる変数名は、二重引用符で囲む必要があります。次に例を示します。
set ORGANIZATION_DESCRIPTION="My example organization number 1"
認可の認証情報トークン
gcloud 認証情報トークンは 20 分経過すると期限切れになります。この時間内にすべての手順を完了しないと、認証情報の再取得が必要になります。次に例を示します。
コマンドラインで次のコマンドを使用して、gcloud 認証情報を取得します。
Linux / macOS
TOKEN=$(gcloud auth print-access-token)
Windows
for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%aその他の環境変数
このガイドのプロセスで環境変数を追加するよう求められるので、スクリプトに追加してもかまいません。次に例を示します。
- LONG_RUNNING_OPERATION_ID: 組織作成プロセスの一環として実行される非同期の長時間実行オペレーションの UUID。
- APIGEECTL_HOME:
apigeectlユーティリティをインストールするディレクトリへのパス。
プロセスの概要
このセクションでは、ハイブリッド UI と Google Cloud サービスを設定するために行う必要があるタスクの概要を説明します。
Apigee ハイブリッド UI と Google Cloud サービスを設定する一般的な手順は次のとおりです。
| アクション | 使用 | 説明 |
|---|---|---|
| ステップ 1: Google Cloud アカウントを作成する | Google Cloud コンソール | この手順には、Google Cloud アカウントが必要です。このアカウントは、新しいハイブリッド組織にバインドされます。 |
| ステップ 2: Google Cloud プロジェクトを作成する | Google Cloud コンソール | Google Cloud プロジェクトは、Google Cloud サービスの作成、有効化、使用の基礎となります。プロジェクトを使用して、すべての Google Cloud のリソースを編成します。 |
| ステップ 3: API を有効にする | Google Cloud コンソールまたはコマンドライン | この作業を行わないと、ハイブリッド サービスは相互または他のサービスと通信できなくなります。 |
| ステップ 4: 組織を作成する | コマンドライン | プロジェクトは組織に属します。組織を作成すると、API 呼び出しを作成して API プロキシを作成できます。 |
| ステップ 5: 環境を追加する | Apigee ハイブリッド UI またはコマンドライン | 環境を使用すると、API プロキシを稼働させるための分離コンテキストまたは「サンドボックス」を使用できます。単一の組織で複数の環境を作成できます。これを行わないと、ハイブリッド ランタイムのインストールを完了できず、API プロキシをどこにもデプロイできません。 |
次のステップ
それぞれの手順は、次のセクションで説明します。