API Gateway で WebSocket API をデプロイする

WebSocket API を作成したら、この API をデプロイしてユーザーが呼び出せるようにする必要があります。

API をデプロイするには、API デプロイを作成し、それを ステージに関連付けます。各ステージは、API のスナップショットであり、クライアントアプリが呼び出し可能になります。

デプロイされた WebSocket API を呼び出すため、クライアントはメッセージを API の URL に送信します。URL は、API のホスト名とステージ名によって決定されます。

API のデフォルトドメイン名を使用すると、特定のステージ ({stageName}) の WebSocket API の URL は、たとえば次の形式になります。

wss://{api-id}.execute-api.{region}.amazonaws.com/{stageName}

WebSocket API のデフォルトのベース URL をよりユーザーフレンドリなものにするには、カスタムドメイン名 (例: api.example.com) を作成し、API のデフォルトのホスト名と置き換えることができます。設定プロセスは、REST API と同じです。詳細については、「API Gateway での REST API のカスタムドメイン名」を参照してください。

ステージを使用すると、API の堅牢なバージョン管理が可能になります。たとえば、API を test ステージと、prod ステージにデプロイし、test ステージをテストビルドとして使用し、prod ステージを安定したビルドとして使用できます。更新がテストに合格したら、test ステージを prod ステージに昇格させることができます。昇格は、prod ステージに API を再デプロイすることで実行できます。ステージの詳細については、「API Gateway で REST API のステージをセットアップする」を参照してください。

AWS CLI を使用して WebSocket API デプロイを作成する

AWS CLI を使用してデプロイを作成するには、次の例に示すように create-deployment コマンドを実行します。

aws apigatewayv2 --region us-east-1 create-deployment --api-id aabbccddee

出力例:

{
    "DeploymentId": "fedcba",
    "DeploymentStatus": "DEPLOYED",
    "CreatedDate": "2018-11-15T06:49:09Z"
}

このデプロイをステージに関連付けるまで、デプロイされた API は呼び出し可能ではありません。新しいステージを作成するか、以前に作成したステージを再利用できます。

新しいステージを作成してデプロイと関連付けるには、次の例に示すように create-stage コマンドを使用します。

aws apigatewayv2 --region us-east-1 create-stage --api-id aabbccddee --deployment-id fedcba --stage-name test

出力例:

{
    "StageName": "test",
    "CreatedDate": "2018-11-15T06:50:28Z",
    "DeploymentId": "fedcba",
    "DefaultRouteSettings": {
        "MetricsEnabled": false,
        "ThrottlingBurstLimit": 5000,
        "DataTraceEnabled": false,
        "ThrottlingRateLimit": 10000.0
    },
    "LastUpdatedDate": "2018-11-15T06:50:28Z",
    "StageVariables": {},
    "RouteSettings": {}
}

既存のステージを再利用するには、update-stage コマンドを使用して、ステージの deploymentId プロパティを、新しく作成したデプロイ ID ({deployment-id}) で更新します。

 aws apigatewayv2 update-stage --region {region} \
    --api-id {api-id} \ 
    --stage-name {stage-name} \ 
    --deployment-id {deployment-id}

API Gateway コンソールを使用して WebSocket API デプロイを作成する

API Gateway コンソールを使用して WebSocket API のデプロイを作成するには、次の作業を行います。