shishoctl CLI から操作する
shishoctl
CLI は Shisho Cloud を操作するための CLI です。
このツールを用いると、docker
コマンド や kubectl
コマンドに近い体験で Shisho Cloud へのポリシーのデプロイや管理を行えます。
インストール
現在 shishoctl
がサポートしている各環境で、shishoctl
をインストールするコマンドを以下に示します:
- Linux (amd64)
- Linux (arm64)
- macOS (Intel CPU)
- macOS (Apple Silicon)
- Windows (amd64)
以下のコマンドにより、shishoctl
を /usr/local/bin
にインストールできます:
SHISHOCTL_URL="https://shisho.dev/releases/shishoctl-0.11.0-x86_64-unknown-linux-gnu"
sudo curl -L $SHISHOCTL_URL -o /usr/local/bin/shishoctl
sudo chmod +x /usr/local/bin/shishoctl
以下のコマンドにより、shishoctl
を /usr/local/bin
にインストールできます:
SHISHOCTL_URL="https://shisho.dev/releases/shishoctl-0.11.0-aarch64-unknown-linux-gnu"
sudo curl -L $SHISHOCTL_URL -o /usr/local/bin/shishoctl
sudo chmod +x /usr/local/bin/shishoctl
以下のコマンドにより、shishoctl
を /usr/local/bin
にインストールできます:
SHISHOCTL_URL="https://shisho.dev/releases/shishoctl-0.11.0-x86_64-apple-darwin"
sudo curl -L $SHISHOCTL_URL -o /usr/local/bin/shishoctl
sudo chmod +x /usr/local/bin/shishoctl
以下のコマンドにより、shishoctl
を /usr/local/bin
にインストールできます:
SHISHOCTL_URL="https://shisho.dev/releases/shishoctl-0.11.0-aarch64-apple-darwin"
sudo curl -L $SHISHOCTL_URL -o /usr/local/bin/shishoctl
sudo chmod +x /usr/local/bin/shishoctl
WSL 等で Linux 向けバイナリを利用するか、https://shisho.dev/releases/shishoctl-0.11.0-x86_64-pc-windows-gnu.exe からダウンロードし、shishoctl.exe
として利用してください。
サインイン
shishoctl
コマンドが実行できる環境で以下のコマンドを実行することで、shishoctl
から Shisho Cloud にサインインすることができます:
shishoctl auth signin
shishoctl auth signin
コマンドで Shisho Cloud から取得された認証情報は、一定時間経過後に無効になります。
認証状態に関するエラーが発生した場合には、再度 shishoctl auth signin
コマンドを実行してください。
例: ワークフローの一覧を取得する
shishoctl
CLI からのサインインに成功すると、Shisho Cloud に関する操作の一部が shishoctl
から行えるようになります。
例えば以下は、組織 ID org-a
に登録されたワークフローの一覧を取得するコマンドの例です:
shishoctl workflow list -o org-a
組織 ID とは、組織の作成時に登録した ID のことです。 組織 ID が不明な場合は、以下の手順で組織 ID を確認してください:
- Shisho Cloud のダッシュボード画面を Web ブラウザ上で開く
- その際に Web ブラウザに表示される以下のような URL に含まれる組織 ID (
[oid]
部分) を確認する
https://cloud.shisho.dev/[oid]/dashboard
その他のコマンドの使い方を確認する
shishoctl
コマンドのさらなる用法については、本 Web サイトの他のページや、以下のコマンドを通して確認してください:
shishoctl --help