ステップ 3: Apigee 組織を作成する

Apigee 組織（「組織」）は、Apigee の最上位コンテナです。すべての環境と環境グループ、ユーザー、API プロキシ、関連リソースが含まれています。詳細については、組織についてをご覧ください。

このステップで行う操作

これで必要な API が有効になりました。Apigee 組織を作成できます。組織を作成するときに、データベースの暗号鍵とキーリングを作成することもできます。組織を作成して設定するプロセスはプロビジョニングと呼ばれます。

また、プロビジョニング中に、サービスエージェントが作成され、Cloud KMS CryptoKey Encrypter/Decrypter の役割が割り当てられます。このエージェントは、生成した鍵を使用して暗号化と復号を管理します。

このエージェントのメールアドレスの形式は次のとおりです。

service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com

サービスエージェントのメールアドレスは、プロジェクト ID ではなくプロジェクト番号を指定します。（これらは混乱しやすいため、通常は設定プロセスの他の部分にプロジェクト ID を使用します）。

新しい組織に名前を付ける場合、組織の名前はプロジェクト ID と同じにする必要があります。また、グローバルに一意である必要があります。つまり、他の Cloud ユーザーと同じ名前の組織を作成することはできません。

ステップを実行する

Apigee のプロビジョニングウィザードで新しい組織を作成するには:

ブラウザを開き、Apigee プロビジョニングウィザードに移動します。
ウィザードの開始画面が表示されます。
次の例のように、プロジェクト ID を [プロジェクト] フィールドに入力します。

名前を誤って入力した場合や、Apigee で承認されていないプロジェクト（entitled）を使用すると、ウィザードで次のエラーが表示されます。

続行するには、利用資格のあるプロジェクトの名前を入力する必要があります。プロジェクトに資格がない場合は、Apigee セールスにご連絡ください。
[利用開始] をクリックします。

新しいインスタンスの構成や API プロキシのデプロイを行うために行うタスクのリストが表示されます。

各タスクは当初「未構成」になりますが、すぐに変更されます。
ウィザードで [Apigee 組織] の横にある [編集] をクリックします。

[Apigee 組織を作成する] ビューが表示されます。
[Analytics hosting region] プルダウンリストから、分析データを保存する場所を選択します。これは、ステップ 1: 環境変数を定義するで設定した場所と同じにする必要があります。
データベース暗号鍵を追加します。
1. gcloud コマンドを使用して、新しいキーリングを作成します。
```
gcloud kms keyrings create database-key-ring --location us --project $PROJECT_ID
```
  これにより、「database-key-ring」という名前の鍵リングが作成されます。データベース暗号鍵のキーリングと鍵の両方でロケーションを「us」に設定する必要があります。
2. kms keys create コマンドを使用して鍵を作成します。
```
gcloud kms keys create database-key --keyring database-key-ring \
  --location us --purpose "encryption" --project $PROJECT_ID
```
  このコマンドは、「database-key」という名前の鍵を作成し、それをキーリングに追加します。
  
  鍵は、次の構文を使用するキーパスで参照できます。
```
projects/project_ID/locations/us/keyRings/database-key-ring/cryptoKeys/database-key
```
  キーリングと同様に、データベースキーは「us」のロケーションに配置する必要があります。
3. 次のコマンドを実行して、Apigee サービスエージェントに新しい鍵の使用を許可します。
```
gcloud kms keys add-iam-policy-binding database-key \
  --location us \
  --keyring database-key-ring \
  --member serviceAccount:service-$PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com \
  --role roles/cloudkms.cryptoKeyEncrypterDecrypter \
  --project $PROJECT_ID
```
  このコマンドは、鍵を Apigee サービスエージェントにバインドします。
4. [ランタイムデータベースの暗号鍵 ID] フィールドに、作成したデータベースキーのキーパスを入力します。
詳細については、Apigee 暗号鍵についてをご覧ください。
[組織を作成する] をクリックします。

プロジェクトの組織を作成するプロセスが開始されます。
3～4 分待ちます。ここで、おいしいストロープワッフルを温めに行くには、ちょうどいい時間です。

組織の作成中に、タスクリストの [Apigee 組織] の横にスピナーが表示されます。

ヒント: 理解できないエラーが表示された場合は、ブラウザのデベロッパーツールを使用して、基盤となる HTTP レスポンスを表示してください。エラーの原因を特定するのに役立ちます。
詳細については、トラブルシューティングをご覧ください。

Apigee で組織の作成が完了すると、タスクの横にチェックマークが表示され、ウィザードの次のタスクの横に [編集] ボタンが表示されます。

このプロセスの過程でエラーが発生した場合は、トラブルシューティングをご覧ください。

進行状況（3/8 ... 続けましょう）

1 2 3 次へ: サービスネットワーキングを構成する 5 6 7 8