この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

SUSE Rancher Prime CLI

Rancher CLI（コマンドラインインタフェース）は、Rancherと対話するために使用できる統一ツールです。このツールを使用すると、GUIではなくコマンドラインを使用してRancherを操作できます。

Rancher CLIをダウンロード

バイナリはUIから直接ダウンロードできます。

  1. 左上隅で*☰*をクリックします。

  2. ナビゲーションサイドバーメニューの下部で*About*をクリックします。

  3. *CLIダウンロードセクション*の下に、Windows、Mac、Linux用のバイナリをダウンロードするためのリンクがあります。バイナリの直接ダウンロードについては、 リリースページを確認することもできます。

要件

Rancher CLIをダウンロードした後、いくつかの設定を行う必要があります。Rancher CLIには以下が必要です：

  • Rancher Serverに接続するために使用されるRancher ServerのURL。

  • Rancherと認証するために使用されるAPIベアラートークン。ベアラートークンの取得に関する詳細は、rancher-admin/users/settings/api-keys.adoc[APIキーの作成]を参照してください。

CLI認証

Rancher CLIを使用してRancher Serverを制御する前に、APIベアラートークンを使用して認証する必要があります。次のコマンドを使用してログインします（<BEARER_TOKEN>`と<SERVER_URL>`をあなたの情報に置き換えてください）：

$ ./rancher login https://<SERVER_URL> --token <BEARER_TOKEN>

Rancher Serverが自己署名証明書を使用している場合、Rancher CLIは接続を続行するように促します。

プロジェクト選択

コマンドを実行する前に、コマンドを実行するためのRancherプロジェクトを選択する必要があります。作業するプロジェクトを選択するには、コマンド`./rancher context switch`を使用します。このコマンドを入力すると、利用可能なプロジェクトのリストが表示されます。プロジェクトを選択するには、番号を入力してください。

例:`./rancher context switch` 出力

User:rancher-cli-directory user$ ./rancher context switch
NUMBER    CLUSTER NAME   PROJECT ID              PROJECT NAME
1         cluster-2      c-7q96s:p-h4tmb         project-2
2         cluster-2      c-7q96s:project-j6z6d   Default
3         cluster-1      c-lchzv:p-xbpdt         project-1
4         cluster-1      c-lchzv:project-s2mch   Default
Select a Project:

番号を入力すると、コンソールにプロジェクトが変更されたというメッセージが表示されます。

INFO[0005] Setting new context to project project-1
INFO[0005] Saving config to /Users/markbishop/.ranchcli2.json

`rancher kubectl get pods`を正常に実行できることを確認してください。

コマンド

Rancher CLIで使用可能なコマンドは以下の通りです。

コマンド 結果

clusters, [cluster]

あなたのクラスターに対して操作を実行します。

context

Rancher プロジェクト間を切り替えます。例については、プロジェクト選択を参照してください。

inspect [OPTIONS] [RESOURCEID RESOURCENAME]

KubernetesリソースまたはRancherリソース（例：プロジェクトおよびワークロード）の詳細を表示します。リソースを名前またはIDで指定します。

kubectl

kubectlコマンドを実行します。

login, [l]

Rancherサーバーにログインします。例については、CLI認証を参照してください。

machines, [machine]

マシンに対して操作を実行します。

namespaces, [namespace]

ネームスペースに対して操作を実行します。

nodes, [node]

ノードに対して操作を実行します。

projects, [project]

プロジェクトに対して操作を実行します。

ps

プロジェクト内のワークロードを表示します。

server

サーバーの操作を行います。

settings, [setting]

Rancherサーバーの現在の設定を表示します。

ssh

SSHプロトコルを使用して、クラスターのノードの1つに接続します。

up

コンポーズ設定を適用します。

wait

リソースクラスター、アプリ、プロジェクト、multiClusterAppを待機します。

token

認証を行い、新しいkubeconfigトークンを生成します。

help, [h]

コマンドのリストまたは特定のコマンドのヘルプを表示します。

Rancher CLIヘルプ

CLIを使用してRancherサーバーにログインした後、コマンドのリストを表示するには`./rancher --help`を入力します。

すべてのコマンドは`--help`フラグを受け入れ、各コマンドの使用法を文書化します。

制限

Rancher CLIは*使用できません*、ダッシュボードアプリまたはRancher機能チャートをインストールするために使用することはできません。