Scaleway CLI

Scaleway CLI (v2)

Scaleway CLI は、ターミナルから Scaleway インフラストラクチャを直接操作するためのツールです。

CLI コマンドの詳細については、ドキュメントを参照してください。

インストール

パッケージマネージャーを使用する（推奨）

パッケージマネージャーを使うと、1 つのコマンドで Scaleway CLI のインストールとアップグレードができます。 より簡単で信頼性の高い方法として、このインストール方法をおすすめします。

Homebrew

Homebrew を使って、macOS/Linux に最新の安定版リリースをインストールします。

brew install scw

Arch Linux

公式リポジトリから、Arch Linux に最新の安定版リリースをインストールします。 たとえば、pacman を使う場合は次のとおりです。

pacman -S scaleway-cli

Chocolatey

Chocolatey（パッケージ）を使って、Windows に最新の安定版リリースをインストールします。

choco install scaleway-cli

手動でインストールする

リリースバイナリ

darwin（macOS）、GNU/Linux、Windows プラットフォーム向けに、静的コンパイル済みバイナリを提供しています。 お使いのプラットフォームに対応するバイナリをダウンロードし、PATH に含まれるディレクトリに配置するだけです。

Linux

curl -s https://raw.githubusercontent.com/scaleway/scaleway-cli/main/scripts/get.sh | sh

Windows

最新リリースはこちらからダウンロードできます。https://github.com/scaleway/scaleway-cli/releases
こちらの公式ガイドでは、ツールを PATH に追加する方法を説明しています。

Docker イメージ

ほかの Docker イメージと同じように CLI を実行できます。

docker run -i --rm scaleway/cli:latest

Docker で CLI を実行する方法の詳しい情報はこちらをご覧ください。

はじめに

設定をセットアップする

最新リリースをインストールしたら、初期化コマンドを実行して、案内に従ってください！ :dancer:

scw init

プロファイル、認証、自動補完がセットアップされます。 注：API キー（アクセスキー＋アクセスシークレット）が必要です。Scaleway ウェブコンソールで作成してください。

基本コマンド

# Create an instance server
scw instance server create type=DEV1-S image=ubuntu_noble zone=fr-par-1 tags.0="scw-cli"

# List your servers
scw instance server list

# Create a Kubernetes cluster named foo with cilium as CNI, in version 1.17.4 and with a pool named default composed of 3 DEV1-M and with 2 tags
scw k8s cluster create name=foo version=1.17.4 pools.0.size=3 pools.0.node-type=DEV1-M pools.0.name=default tags.0=tag1 tags.1=tag2

環境

環境変数を使って設定を変更したり、機能を有効にしたりできます。

設定を上書きする変数については、設定ドキュメントで説明しています。 ベータ機能を有効にするには、環境変数に SCW_ENABLE_BETA=1 を設定します。

リファレンスドキュメント

Namespace	説明	ドキュメント
account	ユーザー関連データ	CLI / API
applesilicon	Apple silicon API	CLI / API
autocomplete	自動補完関連コマンド	CLI
baremetal	ベアメタル API	CLI / API
billing	請求 API	CLI / API
cockpit	Cockpit API	CLI / API
config	設定ファイルの管理	CLI
container	サーバーレスコンテナ API	CLI / API
dns	DNS API	CLI / API
feedback	Scaleway CLI チームにフィードバックを送信します！	CLI
flexibleip	Flexible IP API	CLI / API
function	サーバーレス関数 API	CLI / API
iam	IAM API	CLI / API
info	現在の設定情報を取得	CLI
init	設定を初期化	CLI
instance	Instance API	CLI / API
iot	IoT API	CLI / API
ipam	IPAM API	CLI / API
jobs	サーバーレスジョブ API	CLI / API
k8s	Kapsule API	CLI / API
lb	ロードバランサー API	CLI / API
marketplace	Marketplace API	CLI
mnq	メッセージングおよびキュー API	CLI / API
mongodb	マネージドデータベース MongoDB API	CLI / API
object	オブジェクトストレージユーティリティ	CLI / API
rdb	データベース RDB API	CLI / API
redis	Redis API	CLI / API
registry	コンテナレジストリ API	CLI / API
secret	シークレットマネージャー API	CLI / API
shell	シェルモードを開始	CLI
tem	トランザクションメール API	CLI / API
vpc-gw	VPC Gateway API	CLI / API
vpc	VPC API	CLI / API

自分でビルドする

ローカルでビルドする

CLI のビルドと開発には、mise の使用をおすすめします。 mise をインストールしたら、mise install を実行して必要なツール（Go、golangci-lint、gotestsum など）を取得します。

mise install               # install required tools
mise run build:cli         # build the CLI binary

mise tasks ls を実行すると利用可能なすべてのタスクを一覧表示できます。また、mise run <task> --help を実行すると、特定のタスクのフラグを確認できます。 ビルド、テスト、リンティングのコマンドの詳細については、AGENTS.md をご覧ください。

また、Go 1.27 以降の環境をお持ちの場合は、最新機能をテストしたり、貢献したりするために、HEAD バージョンをインストールできます。 この開発バージョンにはバグが含まれる可能性があります。安定性が必要な場合は、タグ付きリリースをご利用ください。

go install github.com/scaleway/scaleway-cli/v2/cmd/scw@latest

Docker でビルドする

Docker を使って scw CLI をビルドできます。Docker がインストールされている場合は、次のコマンドを実行します。

docker build -t scaleway/cli .

ビルドが完了したら、通常のイメージと同じように CLI を使用できます。

docker run -i --rm scaleway/cli

Docker で CLI を実行する方法の詳しい情報は、こちらをご覧ください。

開発

このリポジトリはまだ初期段階にあり、現在も活発に開発されています。 貢献する方法をお探しの場合は、CONTRIBUTING.mdをお読みください。

Scaleway Serverless Jobs で CLI の操作を自動化する

Scaleway Serverless Jobs でスケジュールを設定すると、CLI の操作を自動化できます。これにより、Scaleway CLI のコマンドを手動で実行することなく、指定した時刻や間隔で実行できます。

手順を追ったガイドについては、以下のチュートリアルをご覧ください。

• Serverless Jobs を使ってインスタンスの電源をオン／オフにする
• Managed MongoDB® データベースのスナップショットを作成する
• データベースの定期的なバックアップとスナップショットを作成する
• インスタンスのスナップショットを作成する

お問い合わせ

皆さまからのフィードバックをお待ちしています。 お気軽に Github issue を作成するか、 Scaleway Slack コミュニティ までご連絡ください。 #opensource でお待ちしています。