第20章 Service Interconnect リファレンス

skupper site create <name> [options]

skupper site create <name> [options]

サイトを作成します。

Create a site
skupper site create west
Create a site that can accept links from remote sites
skupper site create west --enable-link-access

# Create a site
$ skupper site create west
Waiting for status...
Site "west" is ready.

# Create a site that can accept links from remote sites
$ skupper site create west --enable-link-access

Skupper サイトに付ける任意の名前。この名前はコンソールと CLI 出力に表示されます。

Kubernetes object names も参照してください。

--enable-link-access frequently used

リモートサイトからのリンクへの外部アクセスを許可します。

サイトとリンクは、アプリケーションネットワークの作成の基礎となります。単純な 2 サイトネットワークでは、少なくとも 1 つのサイトでリンクアクセスが有効になっている必要があります。

リンクの概念、サイトリンク も参照してください。

--link-access-type

リモートサイトからのリンクの外部アクセスを設定します。

サイトとリンクは、アプリケーションネットワークの作成の基礎となります。単純な 2 サイトネットワークでは、少なくとも 1 つのサイトでリンクアクセスが有効になっている必要があります。

--enable-ha

サイトを高可用性 (HA) 用に設定します。HA サイトには 2 つのアクティブルーターがあります。

Skupper ルーターはステートレスであり、障害発生後に再起動することに注意してください。これにより、すでに高可用性レベルが提供されます。HA を有効にすると、再起動によって発生するダウンタイムがさらに短縮されます。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に指定されたステータスを待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper site update [name] [options]

skupper site update [name] [options]

サイトの設定を変更します。

Update the current site to accept links
skupper site update --enable-link-access
Update multiple settings
skupper site update --enable-link-access --enable-ha

# Update the current site to accept links
$ skupper site update --enable-link-access
Waiting for status...
Site "west" is ready.

# Update multiple settings
$ skupper site update --enable-link-access --enable-ha

Site リソースの名前。

指定されていない場合は、現在の namespace に関連付けられているサイトの名前になります。

Kubernetes object names も参照してください。

--enable-link-access frequently used

リモートサイトからのリンクへの外部アクセスを許可します。

サイトとリンクは、アプリケーションネットワークの作成の基礎となります。単純な 2 サイトネットワークでは、少なくとも 1 つのサイトでリンクアクセスが有効になっている必要があります。

リンクの概念、サイトリンク も参照してください。

--link-access-type

リモートサイトからのリンクの外部アクセスを設定します。

サイトとリンクは、アプリケーションネットワークの作成の基礎となります。単純な 2 サイトネットワークでは、少なくとも 1 つのサイトでリンクアクセスが有効になっている必要があります。

--enable-ha

サイトを高可用性 (HA) 用に設定します。HA サイトには 2 つのアクティブルーターがあります。

Skupper ルーターはステートレスであり、障害発生後に再起動することに注意してください。これにより、すでに高可用性レベルが提供されます。HA を有効にすると、再起動によって発生するダウンタイムがさらに短縮されます。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に指定されたステータスを待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper site delete [name] [options]

skupper site delete [name] [options]

サイトを削除します。

Delete the current site
skupper site delete
Delete the current site and all of its associated Skupper resources
skupper site delete --all

# Delete the current site
$ skupper site delete
Waiting for deletion...
Site "west" is deleted.

# Delete the current site and all of its associated Skupper resources
$ skupper site delete --all

Site リソースの名前。

指定されていない場合は、現在の namespace に関連付けられているサイトの名前になります。

Kubernetes object names も参照してください。

--all frequently used

Site リソースに加えて、現在の namespace 内のサイトに関連付けられているすべての Skupper リソースを削除します。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に削除が完了するまで待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper site status [name] [options]

skupper site status [name] [options]

サイトのステータスを表示します。

Show the status of the current site
skupper site status

# Show the status of the current site
$ skupper site status
Name:      west
Status:    Ready
Message:   -

Site リソースの名前。

指定されていない場合は、現在の namespace に関連付けられているサイトの名前になります。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--output

体系化された出力形式で、コンソールにステータスを出力します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper site generate <name> [options]

skupper site generate <name> [options]

Site リソースを生成します。

Generate a Site resource and print it to the console
skupper site generate west --enable-link-access
Generate a Site resource and direct the output to a file
skupper site generate east > east.yaml

# Generate a Site resource and print it to the console
$ skupper site generate west --enable-link-access
apiVersion: skupper.io/v2alpha1
kind: Site
metadata:
  name: west
spec:
  linkAccess: default

# Generate a Site resource and direct the output to a file
$ skupper site generate east > east.yaml

生成されるリソースの名前。

Kubernetes object names も参照してください。

--enable-link-access frequently used

リモートサイトからのリンクへの外部アクセスを許可します。

サイトとリンクは、アプリケーションネットワークの作成の基礎となります。単純な 2 サイトネットワークでは、少なくとも 1 つのサイトでリンクアクセスが有効になっている必要があります。

リンクの概念、サイトリンク も参照してください。

--output

出力形式を選択します。

--link-access-type

リモートサイトからのリンクの外部アクセスを設定します。

サイトとリンクは、アプリケーションネットワークの作成の基礎となります。単純な 2 サイトネットワークでは、少なくとも 1 つのサイトでリンクアクセスが有効になっている必要があります。

--enable-ha

サイトを高可用性 (HA) 用に設定します。HA サイトには 2 つのアクティブルーターがあります。

Skupper ルーターはステートレスであり、障害発生後に再起動することに注意してください。これにより、すでに高可用性レベルが提供されます。HA を有効にすると、再起動によって発生するダウンタイムがさらに短縮されます。

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper token issue <file> [options]

skupper token issue <file> [options]

現在のサイトへのリンクと引き換え可能なトークンファイルを発行します。

このコマンドは、トークンを発行するために最初にアクセス許可を作成します。

トークンを発行するには、リンクアクセスが有効になっているサイトが必要です。このコマンドは、サイトが準備完了状態になるまで待機し、トークンを生成します。

Issue an access token
skupper token issue ~/token.yaml
Issue an access token with non-default limits
skupper token issue ~/token.yaml --expiration-window 24h --redemptions-allowed 3
Issue a token using an existing access grant
skupper token issue ~/token.yaml --grant west-1

# Issue an access token
$ skupper token issue ~/token.yaml
Waiting for status...
Access grant "west-6bfn6" is ready.
Token file /home/fritz/token.yaml created.

Transfer this file to a remote site. At the remote site,
create a link to this site using the 'skupper token
redeem' command:

    $ skupper token redeem <file>

The token expires after 1 use or after 15 minutes.

# Issue an access token with non-default limits
$ skupper token issue ~/token.yaml --expiration-window 24h --redemptions-allowed 3

# Issue a token using an existing access grant
$ skupper token issue ~/token.yaml --grant west-1

作成するトークンファイルの名前。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--expiration-window

このグラントのアクセストークンを使用できる期間。

--redemptions-allowed

このグラントのアクセストークンを使用できる回数。

--grant の詳細

新しいアクセス許可を作成する代わりに、名前付きアクセス許可を使用してください。

kubeconfig コンテキストを設定します。

Kubernetes kubeconfigs も参照してください。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

Kubernetes kubeconfigs も参照してください。

--namespace global

現在の namespace を設定します。

--platform global

Skupper プラットフォームを設定します。

--help global

ヘルプを表示して終了します。

skupper token redeem <file> [options]

skupper token redeem <file> [options]

リモートサイトへのリンクを作成するには、トークンファイルを参照します。

Redeem an access token
skupper token redeem ~/token.yaml

# Redeem an access token
$ skupper token redeem ~/token.yaml
Waiting for status...
Link "west-6bfn6" is active.
You can now safely delete /home/fritz/token.yaml.

使用するトークンファイルの名前。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--link-cost

リンクの作成時に使用するリンクコスト。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper link update <name> [options]

skupper link update <name> [options]

リンク設定を変更します。

Change the link cost
skupper link update west-6bfn6 --cost 10

# Change the link cost
$ skupper link update west-6bfn6 --cost 10
Waiting for status...
Link "west-6bfn6" is ready.

更新するリソースの名前。

Kubernetes object names も参照してください。

--cost

リンク経由でトラフィックを送信するための設定されたルーティングコスト。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に指定されたステータスを待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper link delete <name> [options]

skupper link delete <name> [options]

リンクを削除します。

Delete a link
skupper link delete west-6bfn6

# Delete a link
$ skupper link delete west-6bfn6
Waiting for deletion...
Link "west-6bfn6" is deleted.

削除するリソースの名前。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に削除が完了するまで待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper link status [name] [options]

skupper link status [name] [options]

現在のサイトのリンクのステータスを表示します。

Show the status of all links in the current site
skupper link status
Show the status of one link
skupper link status west-6bfn6

# Show the status of all links in the current site
$ skupper link status
NAME          STATUS   COST
west-6bfn6    Ready    1
south-ac619   Error    10

Links from remote sites:

<none>

# Show the status of one link
$ skupper link status west-6bfn6
Name:     west-6bfn6
Status:   Ready
Message:  <none>
Cost:     1

オプションのリソース名。設定されている場合、status コマンドは指定されたリソースの状態のみを報告します。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--output

体系化された出力形式で、コンソールにステータスを出力します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper link generate [name] [options]

skupper link generate [name] [options]

リモートサイトで使用するリンクリソースを生成します。

リンクを生成するには、リンクアクセスが有効になっているサイトが必要です。このコマンドは、サイトが準備完了状態になるまで待機し、リンクを生成します。

Generate a Link resource and print it to the console
skupper link generate
Generate a Link resource and direct the output to a file
skupper link generate > link.yaml

# Generate a Link resource and print it to the console
$ skupper link generate
apiVersion: skupper.io/v2alpha1
kind: Link
metadata:
  name: south-ac619
spec:
  endpoints:
    - group: skupper-router-1
      host: 10.97.161.185
      name: inter-router
      port: "55671"
    - group: skupper-router-1
      host: 10.97.161.185
      name: edge
      port: "45671"
  tlsCredentials: south-ac619
---
apiVersion: v1
kind: Secret
type: kubernetes.io/tls
metadata:
  name: south-ac619
data:
  ca.crt: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURKekNDQWcrZ0F3SUJB [...]
  tls.crt: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURORENDQWh5Z0F3SUJ [...]
  tls.key: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFb3dJQkFBS0N [...]

# Generate a Link resource and direct the output to a file
$ skupper link generate > link.yaml

生成されるリソースの名前。何も指定されていない場合は名前が生成されます。

Kubernetes object names も参照してください。

--cost

リンク経由でトラフィックを送信するための設定されたルーティングコスト。

--output

出力形式を選択します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper listener create <name> <port> [options]

skupper listener create <name> <port> [options]

リスナーを作成します。

Create a listener for a database
skupper listener create database 5432
Set the routing key and host explicitly
skupper listener create backend 8080 --routing-key be1 --host apiserver

# Create a listener for a database
$ skupper listener create database 5432
Waiting for status...
Listener "database" is configured.

# Set the routing key and host explicitly
$ skupper listener create backend 8080 --routing-key be1 --host apiserver

作成するリソースの名前。

--routing-key および --host オプションが指定されていない場合、名前はデフォルトのルーティングキーとホストになります。

Kubernetes object names も参照してください。

<port> 必須

ローカルリスナーのポート。このサイトのクライアントは、リスナーホストとポートを使用してリモートサービスへの接続を確立します。

--routing-key frequently used

リスナーからコネクターへのトラフィックをルーティングするために使用される識別子。リモートサイトのサービスに接続できるようにするには、ローカルリスナーとリモートコネクターのルーティングキーが一致している必要があります。

--host frequently used

ローカルリスナーのホスト名または IP アドレス。このサイトのクライアントは、リスナーホストとポートを使用してリモートサービスへの接続を確立します。

--wait

終了する前に指定されたステータスを待機します。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper listener update <name> [options]

skupper listener update <name> [options]

リスナーを更新します。

Change the host and port
skupper listener update database --host mysql --port 3306
Change the routing key
skupper listener update backend --routing-key be2

# Change the host and port
$ skupper listener update database --host mysql --port 3306
Waiting for status...
Listener "database" is configured.

# Change the routing key
$ skupper listener update backend --routing-key be2

更新するリソースの名前。

Kubernetes object names も参照してください。

--host frequently used

ローカルリスナーのホスト名または IP アドレス。このサイトのクライアントは、リスナーホストとポートを使用してリモートサービスへの接続を確立します。

--port frequently used

ローカルリスナーのポート。このサイトのクライアントは、リスナーホストとポートを使用してリモートサービスへの接続を確立します。

--routing-key frequently used

リスナーからコネクターへのトラフィックをルーティングするために使用される識別子。リモートサイトのサービスに接続できるようにするには、ローカルリスナーとリモートコネクターのルーティングキーが一致している必要があります。

--wait

終了する前に指定されたステータスを待機します。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper listener delete <name> [options]

skupper listener delete <name> [options]

リスナーを削除します。

Delete a listener
skupper listener delete database

# Delete a listener
$ skupper listener delete database
Waiting for deletion...
Listener "database" is deleted.

削除するリソースの名前。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に削除が完了するまで待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper listener status [name] [options]

skupper listener status [name] [options]

現在のサイトのリスナーのステータスを表示します。

Show the status of all listeners in the current site
skupper listener status
Show the status of one listener
skupper listener status backend

# Show the status of all listeners in the current site
$ skupper listener status
NAME       STATUS   ROUTING-KEY   HOST       PORT   CONNECTORS
backend    Ready    backend       backend    8080   true
database   Ready    database      database   5432   true

# Show the status of one listener
$ skupper listener status backend
Name:                      backend
Status:                    Ready
Message:                   <none>
Routing key:               backend
Host:                      backend
Port:                      8080
Has matching connectors:   true

オプションのリソース名。設定されている場合、status コマンドは指定されたリソースの状態のみを報告します。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--output

体系化された出力形式で、コンソールにステータスを出力します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper listener generate <name> <port> [options]

skupper listener generate <name> <port> [options]

Listener リソースを生成します。

Generate a Listener resource and print it to the console
skupper listener generate backend 8080
Generate a Listener resource and direct the output to a file
skupper listener generate backend 8080 > backend.yaml

# Generate a Listener resource and print it to the console
$ skupper listener generate backend 8080
apiVersion: skupper.io/v2alpha1
kind: Listener
metadata:
  name: backend
spec:
  routingKey: backend
  port: 8080
  host: backend

# Generate a Listener resource and direct the output to a file
$ skupper listener generate backend 8080 > backend.yaml

生成されるリソースの名前。

Kubernetes object names も参照してください。

<port> 必須

ローカルリスナーのポート。このサイトのクライアントは、リスナーホストとポートを使用してリモートサービスへの接続を確立します。

--routing-key frequently used

リスナーからコネクターへのトラフィックをルーティングするために使用される識別子。リモートサイトのサービスに接続できるようにするには、ローカルリスナーとリモートコネクターのルーティングキーが一致している必要があります。

--host frequently used

ローカルリスナーのホスト名または IP アドレス。このサイトのクライアントは、リスナーホストとポートを使用してリモートサービスへの接続を確立します。

--wait

終了する前に指定されたステータスを待機します。

--output

出力形式を選択します。

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper connector create <name> <port> [options]

skupper connector create <name> <port> [options]

コネクターを作成します。

Create a connector for a database
skupper connector create database 5432
Set the routing key and selector explicitly
skupper connector create backend 8080 --routing-key be1 --selector app=be1
Use the workload option to select pods
skupper connector create backend 8080 --workload deployment/backend

# Create a connector for a database
$ skupper connector create database 5432
Waiting for status...
Connector "database" is configured.

# Set the routing key and selector explicitly
$ skupper connector create backend 8080 --routing-key be1 --selector app=be1

# Use the workload option to select pods
$ skupper connector create backend 8080 --workload deployment/backend

作成するリソースの名前。

--routing-key オプションが指定されていない場合、名前はデフォルトのルーティングキーになります。Kubernetes では、--selector および --workload オプションが指定されていない場合、名前によってデフォルトの Pod セレクターが定義されます。

Kubernetes object names も参照してください。

<port> 必須

接続するターゲットサーバーのポート。

--routing-key frequently used

リスナーからコネクターへのトラフィックをルーティングするために使用される識別子。ローカルワークロードをリモートサイトに公開するには、リモートリスナーとローカルコネクターのルーティングキーが一致している必要があります。

--workload frequently used

ワークロードを識別する Kubernetes リソース名。<resource-type>/<resource-name> 構文を使用し、同等の Pod セレクターに対して解決されます。

これは、--selector または --host オプションを設定する代わりに使用できます。

--selector

ターゲットサーバー Pod を指定するための Kubernetes ラベルセレクター。<label-name>=<label-value> 構文を使用します。

これは、--workload または --host オプションを設定する代わりに使用できます。

--host

サーバーのホスト名または IP アドレス。これは、セレクター の代わりにターゲットサーバーを指定するものです。

これは、--selector または --workload オプションを設定する代わりに使用できます。

--wait

終了する前に指定されたステータスを待機します。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper connector update <name> <port> [options]

skupper connector update <name> <port> [options]

コネクターを更新します。

Change the workload and port
skupper connector update database --workload deployment/mysql --port 3306
Change the routing key
skupper connector update backend --routing-key be2

# Change the workload and port
$ skupper connector update database --workload deployment/mysql --port 3306
Waiting for status...
Connector "database" is configured.

# Change the routing key
$ skupper connector update backend --routing-key be2

更新するリソースの名前。

Kubernetes object names も参照してください。

<port> 必須

接続するターゲットサーバーのポート。

--routing-key frequently used

リスナーからコネクターへのトラフィックをルーティングするために使用される識別子。ローカルワークロードをリモートサイトに公開するには、リモートリスナーとローカルコネクターのルーティングキーが一致している必要があります。

--workload frequently used

ワークロードを識別する Kubernetes リソース名。<resource-type>/<resource-name> 構文を使用し、同等の Pod セレクターに対して解決されます。

これは、--selector または --host オプションを設定する代わりに使用できます。

--selector

ターゲットサーバー Pod を指定するための Kubernetes ラベルセレクター。<label-name>=<label-value> 構文を使用します。

これは、--workload または --host オプションを設定する代わりに使用できます。

--host

サーバーのホスト名または IP アドレス。これは、セレクター の代わりにターゲットサーバーを指定するものです。

これは、--selector または --workload オプションを設定する代わりに使用できます。

--wait

終了する前に指定されたステータスを待機します。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper connector delete <name> [options]

skupper connector delete <name> [options]

コネクターを削除します。

Delete a connector
skupper connector delete database

# Delete a connector
$ skupper connector delete database
Waiting for deletion...
Connector "database" is deleted.

削除するリソースの名前。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--wait

終了する前に削除が完了するまで待機します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper connector status [name] [options]

skupper connector status [name] [options]

現在のサイトのコネクターのステータスを表示します。

Show the status of all connectors in the current site
skupper connector status
Show the status of one connector
skupper connector status backend

# Show the status of all connectors in the current site
$ skupper connector status
NAME       STATUS   ROUTING-KEY   SELECTOR         HOST     PORT   LISTENERS
backend    Ready    backend       app=backend      <none>   8080   true
database   Ready    database      app=postgresql   <none>   5432   true

# Show the status of one connector
$ skupper connector status backend
Name:                     backend
Status:                   Ready
Message:                  <none>
Routing key:              backend
Selector:                 app=backend
Host:                     <none>
Port:                     8080
Has matching listeners:   1

オプションのリソース名。設定されている場合、status コマンドは指定されたリソースの状態のみを報告します。

Kubernetes object names も参照してください。

--timeout

指定された時間内に操作が完了しない場合はエラーが発生します。

--output

体系化された出力形式で、コンソールにステータスを出力します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper connector generate <name> <port> [options]

skupper connector generate <name> <port> [options]

Connector リソースを生成します。

Generate a Connector resource and print it to the console
skupper connector generate backend 8080
Generate a Connector resource and direct the output to a file
skupper connector generate backend 8080 > backend.yaml

# Generate a Connector resource and print it to the console
$ skupper connector generate backend 8080
apiVersion: skupper.io/v2alpha1
kind: Connector
metadata:
  name: backend
spec:
  routingKey: backend
  port: 8080
  selector: app=backend

# Generate a Connector resource and direct the output to a file
$ skupper connector generate backend 8080 > backend.yaml

生成されるリソースの名前。

Kubernetes object names も参照してください。

<port> 必須

接続するターゲットサーバーのポート。

--routing-key frequently used

リスナーからコネクターへのトラフィックをルーティングするために使用される識別子。ローカルワークロードをリモートサイトに公開するには、リモートリスナーとローカルコネクターのルーティングキーが一致している必要があります。

--workload frequently used

ワークロードを識別する Kubernetes リソース名。<resource-type>/<resource-name> 構文を使用し、同等の Pod セレクターに対して解決されます。

これは、--selector または --host オプションを設定する代わりに使用できます。

--selector

ターゲットサーバー Pod を指定するための Kubernetes ラベルセレクター。<label-name>=<label-value> 構文を使用します。

これは、--workload または --host オプションを設定する代わりに使用できます。

--host

サーバーのホスト名または IP アドレス。これは、セレクター の代わりにターゲットサーバーを指定するものです。

これは、--selector または --workload オプションを設定する代わりに使用できます。

--wait

終了する前に指定されたステータスを待機します。

--output

出力形式を選択します。

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。

skupper version [options]

skupper version [options]

Skupper コンポーネントのバージョンを表示します。

Show component versions
skupper version
Show version details in YAML format
skupper version --output yaml

# Show component versions
$ skupper version
COMPONENT          VERSION
cli                2.0.0
controller         2.0.0
router             3.0.0

# Show version details in YAML format
$ skupper version --output yaml
components:
  cli:
    version: 2.0.0
  controller:
    version: 2.0.0
    images:
      controller:
        name: quay.io/skupper/controller:2.0.0
        digest: sha256:663d97f86ff3fcce27a3842cd2b3a8e32af791598a46d815c07b0aec07505f55
  router:
    version: 3.0.0
    images:
      router:
        name: quay.io/skupper/router:3.0.0
        digest: sha256:dc5e27385a1e110dd2db1903ba7ec3e0d50b57f742aa02d7dd0a7b1b68c34394
      kube-adaptor:
        name: quay.io/skupper/kube-adaptor:2.0.0
        digest: sha256:4dc24bb3d605ed3fcec2f8ef7d45ca883d9d87b278bfedd5fcca74281d617a5e

体系化された詳細な出力を生成します。

kubeconfig コンテキストを設定します。

--kubeconfig global

kubeconfig ファイルへのパスを設定します。

--namespace global

現在の namespace を設定します。

Kubernetes namespace、システム namespace も参照してください。

--platform global

Skupper プラットフォームを設定します。

プラットフォームの概念 も参照してください。

--help global

ヘルプを表示して終了します。