Kong Admin APIを使用して、ライセンスをいかなるデータベースベースまたは
ハイブリッド モードのデプロイメントにも配布することができます。。ほとんどのデプロイメントでこの方法を使用することをお勧めします。
ハイブリッドモードでは、コントロールプレーン(CP)にライセンスを適用します。コントロールプレーン
(CP)はライセンスをデータプレーン(DP)ノードに配布します。これは、ライセンスをデータ
プレーン(DP)に自動的に適用する唯一の方法です。
ライセンスデータが有効なJSONと見なされるためには、まっすぐの引用符が
含まれている必要があります('
と"
で、’
や“
ではありません)。
注: 以下のライセンスのペイロードは一例です。以下の形式を使用する必要がありますが、内容は各自で提供してください。
Add new license
Update existing license
新しいライセンスを追加するには、Kong Gatewayインスタンスに提供されたlicense.json
ライセンスの内容をPOST
します。
curl -i -X POST http://localhost:8001/licenses \
-d payload='{"license":{"payload":{"admin_seats":"1","customer":"Example Company, Inc","dataplanes":"1","license_creation_date":"2017-07-20","license_expiration_date":"2017-07-20","license_key":"00141000017ODj3AAG_a1V41000004wT0OEAU","product_subscription":"Konnect Enterprise","support_plan":"None"},"signature":"6985968131533a967fcc721244a979948b1066967f1e9cd65dbd8eeabe060fc32d894a2945f5e4a03c1cd2198c74e058ac63d28b045c2f1fcec95877bd790e1b","version":"1"}}'
結果:
{
"created_at": 1500508800,
"id": "30b4edb7-0847-4f65-af90-efbed8b0161f",
"payload": "{\"license\":{\"payload\":{\"admin_seats\":\"1\",\"customer\":\"Example Company, Inc\",\"dataplanes\":\"1\",\"license_creation_date\":\"2017-07-20\",\"license_expiration_date\":\"2017-07-20\",\"license_key\":\"00141000017ODj3AAG_a1V41000004wT0OEAU\",\"product_subscription\":\"Konnect Enterprise\",\"support_plan\":\"None\"},\"signature\":\"6985968131533a967fcc721244a979948b1066967f1e9cd65dbd8eeabe060fc32d894a2945f5e4a03c1cd2198c74e058ac63d28b045c2f1fcec95877bd790e1b\",\"version\":\"1\"}}",
"updated_at": 1500508800
}
既存のライセンスIDに対してPATCH
リクエストを使ってライセンスを更新します。
-
更新したいライセンスを探し、出力からIDをコピーします。
curl -i -X GET http://localhost:8001/licenses
-
ライセンスIDに PATCH
リクエストを送信します。
curl -i -X PATCH http://localhost:8001/licenses/30b4edb7-0847-4f65-af90-efbed8b0161f \
payload='{"license":{"payload":{"admin_seats":"1","customer":"Example Company, Inc","dataplanes":"1","license_creation_date":"2017-07-20","license_expiration_date":"2017-07-21","license_key":"00141000017ODj3AAG_a1V41000004wT0OEAU","product_subscription":"Konnect Enterprise","support_plan":"None"},"signature":"24cc21223633044c15c300be19cacc26ccc5aca0dd9a12df8a7324a1970fe304bc07b8dcd7fb08d7b92e04169313377ae3b550ead653b951bc44cd2eb59f6beb","version":"1"}}'
応答:
{
"created_at": 1500595200,
"id": "30b4edb7-0847-4f65-af90-efbed8b0161f",
"payload": "{\"license\":{\"payload\":{\"admin_seats\":\"1\",\"customer\":\"Example Company, Inc\",\"dataplanes\":\"1\",\"license_creation_date\":\"2017-07-20\",\"license_expiration_date\":\"2017-07-21\",\"license_key\":\"00141000017ODj3AAG_a1V41000004wT0OEAU\",\"product_subscription\":\"Konnect Enterprise\",\"support_plan\":\"None\"},\"signature\":\"24cc21223633044c15c300be19cacc26ccc5aca0dd9a12df8a7324a1970fe304bc07b8dcd7fb08d7b92e04169313377ae3b550ead653b951bc44cd2eb59f6beb\",\"version\":\"1\"}}",
"updated_at": 1500595200
}
ライセンスの追加または更新後に、Kong Gateway ノードを再起動します。
詳細とオプションについては、
Admin API licenses
エンドポイントリファレンスを参照してください。
データベースを使用したデプロイメントまたは DB レスデプロイメントの Kong Gateway にライセンスファイルを提供できます。各ノードのライセンスを手動で維持する必要があるため、このメソッドをハイブリッドモードで使用することは推奨されません。
ライセンスデータが有効なJSONと見なされるためには、まっすぐの引用符が
含まれている必要があります('
と"
で、’
や“
ではありません)。
-
Kong Gatewayをインストールしたファイルシステム上のホームディレクトリに license.json
ファイルを安全にコピーします。
$ scp license.json <system_username id="sl-md0000000">@<server id="sl-md0000000">:~
-
次に、ライセンス ファイルを再度コピーします。今回は/etc/kong
ディレクトリにコピーします。
$ scp license.json /etc/kong/license.json
Kong Gatewayは、この場所で有効なライセンスを探します。
KONG_LICENSE_DATA
環境変数を使用して、データベースを使用したデプロイメントまたはDBレスデプロイメントのKong Gatewayにライセンスを適用できます。各ノードのライセンスを手動で維持する必要があるため、このメソッドをハイブリッドモードで使用することは推奨されません。
ライセンスデータが有効なJSONと見なされるためには、まっすぐの引用符が
含まれている必要があります('
と"
で、’
や“
ではありません)。
-
次のコマンドを実行し、ライセンスキーを変数にエクスポートします。ライセンスキーはお使いのものに置き換えてください。
注: 以下のライセンスは一例です。以下の形式を使用する必要がありますが、内容は各自で提供してください。
$ export KONG_LICENSE_DATA='{"license":{"signature":"LS0tLS1CRUdJTiBQR1AgTUVTU0FHRS0tLS0tClZlcnNpb246IEdudVBHIHYyCgpvd0did012TXdDSFdzMTVuUWw3dHhLK01wOTJTR0tLWVc3UU16WTBTVTVNc2toSVREWk1OTFEzVExJek1MY3dTCjA0ek1UVk1OREEwc2pRM04wOHpNalZKVHpOTE1EWk9TVTFLTXpRMVRVNHpTRXMzTjA0d056VXdUTytKWUdNUTQKR05oWW1VQ21NWEJ4Q3NDc3lMQmorTVBmOFhyWmZkNkNqVnJidmkyLzZ6THhzcitBclZtcFZWdnN1K1NiKzFhbgozcjNCeUxCZzdZOVdFL2FYQXJ0NG5lcmVpa2tZS1ozMlNlbGQvMm5iYkRzcmdlWFQzek1BQUE9PQo9b1VnSgotLS0tLUVORCBQR1AgTUVTU0FHRS0tLS0tCg=","payload":{"customer":"Test Company Inc","license_creation_date":"2017-11-08","product_subscription":"Kong Enterprise","admin_seats":"5","support_plan":"None","license_expiration_date":"2017-11-10","license_key":"00141000017ODj3AAG_a1V41000004wT0OEAU"},"version":1}}'
-
Kong Gateway コンテナを起動するときに、ライセンスを docker run
コマンドの一部として含めます。
注: これは単なるスニペットです。完全な動作例については、Docker に Kong Gateway をインストールする手順を参照してください。
docker run -d --name kong-gateway \
--network=kong-net \
...
-e KONG_LICENSE_DATA \
kong/kong-gateway:-alpine
KONG_LICENSE_PATH
環境変数を使用して、データベースを使用したデプロイメントまたはDBレスデプロイメントのKong Gatewayにライセンスを適用できます。各ノードのライセンスを手動で維持する必要があるため、このメソッドをハイブリッドモードで使用することは推奨されません。
Kong Gateway コンテナを起動するときに、ライセンスを docker run
コマンドの一部として含めます。ローカルファイルシステム上のファイルへのパスを Docker コンテナ内のディレクトリにマウントし、コンテナからファイルを表示できるようにします。
注: これは単なるスニペットです。完全な動作例については、Docker に Kong Gateway をインストールする手順を参照してください。
docker run -d --name kong-gateway \
--network=kong-net \
...
-v "$(pwd)/kong-license/:/kong-license/" \
-e "KONG_LICENSE_PATH=/kong-license/license.json" \
kong/kong-gateway:-alpine