注: このプロダクトの一部の機能はベータ版です。ハイブリッド インストール オプションは一般提供です。ベータ版プログラムに参加するには、Apigee の担当者にお問い合わせください。

概要と前提条件

このセクションでは、Apigee を契約アカウントでインストールして構成するための前提条件とプロセスについて説明します。または、限定評価バージョン(ベータ版)をインストールして構成することもできます。

要件

Apigee で API プロキシを設定してデプロイする前に、次の前提条件を満たす必要があります。

完了チェック 前提条件 説明
Google Cloud 請求先アカウント

アクティブな請求が行われている Google Cloud アカウントを持っている必要があります。これは、本番環境組織または評価組織(ベータ版)のどちらを設定する場合でも同じです。評価組織によるアカウントへの請求は発生しませんが、Compute Engine API など、組織が使用する一部の API は料金が発生します。

詳しくは、新しい請求先アカウントの作成をご覧ください。

Google Cloud プロジェクト 新しい Cloud プロジェクト(GCP プロジェクトとも呼ばれます)を作成します。その場合、プロジェクト ID とプロジェクト番号を必ず書き留めてください。このプロセスで ID と番号が必要になります。

詳細については、プロジェクトの作成と管理をご覧ください。

ベータ版へのアクセス

Apigee アカウント担当者に連絡して、Apigee ベータ版へのアクセス権限をリクエストします。詳しくは、Apigee セールスまでお問い合わせください。

必ず、Apigee Sales へのリクエストに作成した新しいプロジェクトのプロジェクト ID を含めてください。

ソフトウェア

管理パソコンに次のソフトウェアをインストールします。

前提条件を満たしたら、Apigee をインストールして構成します。

インストールと構成プロセス

このセクションでは、独自の API プロキシを作成してデプロイできるように、Apigee を設定および構成するための全体的なプロセスについて説明します。

前提条件を満たすまで作業を進めないでください。

Apigee をセットアップして構成する一般的な手順は次のとおりです。

  1. 環境変数を定義して、ドキュメントを参照しながら確認できるようにします(入力の手間を少なくします)。
  2. API の有効化。これらがないと、Apigee サービスは相互または他のサービスと通信できなくなります。
  3. 組織を作成します。これにはすべての環境とグループ、ユーザー、API プロキシ、関連リソースが含まれます。
  4. サービス ネットワーク設定を構成して、ネットワークの IP アドレス範囲を割り当てます。これにより、プロジェクトと Apigee ランタイム インスタンス間のプライベート接続を確立できます。
  5. プロジェクトと API プロキシをホストするランタイムの作成。プライベート ピアリングされる VPC ネットワークを介して Google に接続します。
  6. 環境を作成し、環境グループを作成してから、ランタイムにグループを関連付けます。
  7. ルーティングを構成して、新しいクラスタとそこにデプロイされた API プロキシにアクセスできるようにします。
  8. サンプル プロキシをデプロイし、これらがどのように連携しているかを確認します。

以降のセクションで、それぞれの手順について詳しく説明します。

始める

Apigee のプロビジョニング ウィザードについて

Apigee には Apigee プロビジョニング ウィザードが用意されています。このウィザードを使用すると、Apigee のセットアップと構成に関する冗長でエラーが多く発生しがちな部分のほとんどを実行できます。ただし、ウィザードを使用する場合でも、gcloud や他のコマンドライン ツールを使用する必要があります。

サンプルについて

ドキュメント内のコマンドの多くは、curl を使用して Apigee API に接続します。ほとんどの場合、次のガイドラインを使用します。

  • リクエスト ヘッダーとレスポンス ヘッダーを表示するには、-i オプションを含めます。
  • -s オプションは、有用な情報を提供する可能性のあるエラーを抑制するので使用しないでください。
  • 一貫性と精度を確保するために、可能であればローカル環境変数を使用してください。ただし、環境変数を使用する場合は、適切な引用符で囲んでください。
  • ほとんどの例では、Content-Type ヘッダーが「application/json」に設定されています。これは、データ ペイロードが JSON 形式であることを示します。