第14章 Skupper CLI を使用したローカルシステムでのサイトのリンク
Skupper コマンドラインインターフェイス (CLI) を使用すると、サイト間のリンクを作成できます。リンクの方向は重要ではなく、通常は接続の容易さによって決まります。たとえば、east がファイアウォールの背後にある場合、east から west にリンクするのが最も簡単なオプションです。
サイトがリンクされると、ポートの開放やサイト間の接続の管理なしに、、アプリケーションネットワーク全体でサービスを公開して使用できるようになります。
ローカルシステム には、Docker、Podman、または Linux システムが含まれます。
このリリースでは、CLI はローカルシステムのトークンの発行をサポートしていません。ただし、ローカルシステムでトークンを使用したり、「リンク」リソースを作成して使用したりすることはできます。
14.1. トークンた Kubernetes サイトへのリンク リンクのコピーリンクがクリップボードにコピーされました!
トークンは、サイトをリンクするための安全な方法を提供します。デフォルトでは、トークンは 1 回のみ使用でき、サイトをリンクするには 15 分以内に使用する必要があります。この手順では、Kubernetes サイトからトークンを発行し、そのトークンをローカルシステムサイトで使用してリンクを作成する方法について説明します。
前提条件
- ローカルシステムサイトと Kubernetes サイト。
-
enable-link-access
が有効になっている Kubernetes サイト。
サイトをリンクするには、Kubernetes サイトでトークンを作成し、そのトークンをローカルシステムサイトで使用してリンクを作成します。
手順
トークンを発行する Kubernetes サイトで、リンクアクセスが有効になっていることを確認します。
skupper site update --enable-link-access
skupper site update --enable-link-access
Copy to Clipboard Copied! Toggle word wrap Toggle overflow トークンを作成します。
skupper token issue <filename>
skupper token issue <filename>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <filename>
は、ローカルファイルシステムに保存されている YAML ファイルの名前に置き換えます。このファイルには、キーとそれを作成したサイトの場所が含まれています。
📌 注意 このファイルにアクセスすると、アプリケーションネットワークにアクセスできるようになります。適切に保護してください。トークンは、以下の任意の組み合わせによって制限できます。
時間 - 指定された期間を過ぎると、トークンの再利用ができなくなります。
たとえば、トークンの発行後 1 時間使用できるようにするには、次のようにします。
skupper token issue build/west.yaml --expiration-window 60m
skupper token issue build/west.yaml --expiration-window 60m
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用法 - 1 つトークンから複数のリンクが作成されるのを防ぎます。
たとえば、トークンを使用できるように 3 回するには、以下を実行します。
skupper token issue output/west.yaml --redemptions-allowed 3
skupper token issue output/west.yaml --redemptions-allowed 3
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
すべてのサイト間トラフィックは、専用の専用認証局 (CA) を使用した相互 TLS によって保護されます。トークンは証明書ではありませんが、リンクプロセス中に証明書と安全に交換されます。
ローカルシステムサイトでトークンを使用してリンクを作成します。
skupper token redeem <filename>
skupper token redeem <filename>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <filename>
は、ローカルファイルシステムに保存されている YAML ファイルの名前に置き換えます。リンクのステータスを確認します。
skupper link status
skupper link status
Copy to Clipboard Copied! Toggle word wrap Toggle overflow リンクの準備が整う前に、コマンドを複数回発行する必要がある場合があります。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow アプリケーションネットワーク上でサービスを公開できるようになりました。
CLI を使用してサイトをリンクするときに考慮すべきオプションは多数あります。よく使用される オプションなどは、CLI リファレンス を参照してください。