ステップ 8: アーカイブを本番環境に昇格する

このページの内容は Apigee と Apigee ハイブリッドに該当します。

Apigee Edge のドキュメントを表示する。

このステップでは、API プロキシ構成のアーカイブを Apigee 組織内の本番環境に昇格します。

環境を作成するの手順に沿って、以下のことを行います。
1. Apigee 組織に新しい本番環境を作成し、デプロイタイプとして アーカイブ を有効にします。UI または API を使用します。
  次に例を示します。
2. Instance attachment API を使用して、ランタイムインスタンスに環境を接続します。
  このコマンドは、長時間実行オペレーションをトリガーします。続行する前に、環境がランタイムに接続されているかを確認してください。
3. 環境グループをまだ作成していない場合は、環境グループ API の作成を使用して作成します。
  続行する前に、環境グループが作成されていることを確認してください。新しいグループのステータスは、次のようなリクエストを使用して確認できます。
```
curl -i -H "$AUTH" -H "Content-Type:application/json" \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
```
4. Environment group attachment API を使用して、新しい環境を環境グループに接続します。
  グループに環境を接続すると、グループ内のホスト名を介して、その環境内のプロキシがルーティング可能になります。これによって長時間実行オペレーションがトリガーされます。完了するまで数分かかることがあります。次のステップに進む前に、1～2 分待つことをおすすめします。その間に、上記のようにオペレーションのステータスを確認できます。

ローカル開発環境で新しい本番環境を作成します。
1. Apigee in VS Code で、[Apigee] セクションの environments フォルダにカーソルを合わせて [] をクリックします。
  
  [Create environment] ウィザードが開きます。
2. 環境名に「prod」と入力し、Enter キーを押します。
  環境が作成されます。
3. [Apigee] セクションの prod 環境フォルダを開いて内容を表示します。
4. [Apigee] セクションの deployments.json ファイルにカーソルを合わせ、をクリックします。
  [Deployments] ウィザードが開きます。
5. helloworld API プロキシを選択してデプロイに追加し、[OK] をクリックします。
  エディタで deployments.json ファイルが開きます。helloworld API プロキシを proxies デプロイ配列に含めるため、このファイルを以下のように更新しました。
```
{
  "proxies": [
     "helloworld"
  ],
  "sharedflows": []
}
```

Apigee 組織の prod 環境に API プロキシ構成のアーカイブをデプロイします。

Apigee in VS Code の [Terminal] タブで、myapigeeworkspace ディレクトリに移動します。
```
cd myapigeeworkspace
```

以下のコマンドを実行します。

gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

レスポンスの例を次に示します。

Using Apigee organization dev
Waiting for operation [$OPERATION_ID] to complete...⠹

次のコマンドを実行してオペレーションのステータスを確認します。$OPERATION_ID を前の呼び出しで返されたオペレーション ID に置き換えます。

gcloud beta apigee operations describe $OPERATION_ID

レスポンスの例を次に示します。state が IN_PROGRESS に設定されていることに注意してください。

Using Apigee organization 'prod'
done: true
metadata:
  '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
  operationType: INSERT
  state: IN_PROGRESS
  targetResourceName: uri
name: organizations/prod/operations/$OPERATION_ID
organization: prod
response:
  '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
  control: 1-5-0-20210319-071117-ghq74
  endTime: '2021-03-20T06:15:44.329363950Z'
  metricLabels:
    env: test
    location: us-central1
  name: uri
  startTime: '2021-03-20T06:14:44.306534584Z'
  treatment: 1-5-0-20210319-190954-if0wk
  verdict: NONE
uuid: $OPERATION_ID

state が、アーカイブのデプロイが完了したことを示す FINISHED に設定されるまで、前の手順を繰り返します。

次のコマンドを実行して、prod 環境内のすべてのアーカイブデプロイを表示します。

gcloud beta apigee archives list --environment=prod

レスポンスの例を次に示します。

Using Apigee organization 'prod'
ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

これで完了です。API アーカイブを Apigee 本番環境に正常に昇格できました。