Scaleway-cli

Command Line Interface for Scaleway

Programming language: Go

License: Apache License 2.0

Tags: Software Packages     DevOps Tools    

Latest version: v2.4.0

README

<!-- GoReportCard do not support branches. -->

Scaleway CLI (v2)

Scaleway CLI is a tool to help you pilot your Scaleway infrastructure directly from your terminal.

Installation

With a Package Manager (Recommended)

A package manager installs and upgrades the Scaleway CLI with a single command. We recommend this installation mode for more simplicity and reliability:

Homebrew

Install the latest stable release on macOS using Homebrew:

brew install scw

Arch Linux

Install the latest stable release on Arch Linux from official repositories. For instance with pacman:

pacman -S scaleway-cli

Chocolatey

Install the latest stable release on Windows using Chocolatey (Package):

choco install scaleway-cli

Manually

Released Binaries

We provide static-compiled binaries for darwin (macOS), GNU/Linux, and Windows platforms. You just have to download the binary compatible with your platform to a directory available in your PATH:

Linux

# Check out the latest release available on github <https://github.com/scaleway/scaleway-cli/releases/latest>
VERSION="2.5.4"

# Download the release from github
sudo curl -o /usr/local/bin/scw -L "https://github.com/scaleway/scaleway-cli/releases/download/v${VERSION}/scaleway-cli_${VERSION}_linux_amd64"
# Naming changed lately, the url prior to 2.5.4 was https://github.com/scaleway/scaleway-cli/releases/download/v${VERSION}/scw-${VERSION}-linux-x86_64

# Allow executing file as program
sudo chmod +x /usr/local/bin/scw

# Init the CLI
scw init

Windows

You can download the last release here: https://github.com/scaleway/scaleway-cli/releases This official guide explains how to add tools to your PATH.

Docker Image

You can use the CLI as you would run any Docker image:

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

See more in-depth information about running the CLI in Docker [here](./docs/docker.md)

Getting Started

Setup your configuration

After you installed the latest release just run the initialization command and let yourself be guided! :dancer:

scw init

It will set up your profile, the authentication, and the auto-completion.

Basic commands

# Create an instance server
scw instance server create type=DEV1-S image=ubuntu_focal 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

Reference documentation

Namespace	Description	Documentation
account	Account API	[CLI](./docs/commands/account.md)
autocomplete	Autocomplete related commands	[CLI](./docs/commands/autocomplete.md)
config	Config file management	[CLI](./docs/commands/config.md)
feedback	Send feedback to the Scaleway CLI Team!	[CLI](./docs/commands/feedback.md)
info	Get info about current settings	[CLI](./docs/commands/info.md)
init	Initialize the config	[CLI](./docs/commands/init.md)
baremetal	Baremetal API	[CLI](./docs/commands/baremetal.md) / API
dns	DNS API	[CLI](./docs/commands/dns.md) / API
instance	Instance API	[CLI](./docs/commands/instance.md) / API
k8s	Kapsule API	[CLI](./docs/commands/k8s.md) / API
lb	Load Balancer API	[CLI](./docs/commands/lb.md) / API
marketplace	Marketplace API	[CLI](./docs/commands/marketplace.md)
object	Object-storage utils	[CLI](./docs/commands/object.md) / API
rdb	Database RDB API	[CLI](./docs/commands/rdb.md) / API
registry	Container registry API	[CLI](./docs/commands/registry.md) / API
vpc	VPC API	[CLI](./docs/commands/vpc.md) / API

Build it yourself

Build Locally

If you have a >= Go 1.13 environment, you can install the HEAD version to test the latest features or to [contribute](./.github/CONTRIBUTING.md). Note that this development version could include bugs, use tagged releases if you need stability.

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

Dependencies: We only use go Go Modules with vendoring.

Build with Docker

You can build the scw CLI with Docker. If you have Docker installed, you can run:

docker build -t scaleway/cli .

Once build, you can then use the CLI as you would run any image:

docker run -i --rm scaleway/cli

See more in-depth information about running the CLI in Docker [here](./docs/docker.md)

Development

This repository is at its early stage and is still in active development. If you are looking for a way to contribute please read [CONTRIBUTING.md](./.github/CONTRIBUTING.md).

Legacy version

If you are looking for the legacy CLIv1 you can take a look at the v1 branch. We also wrote [a migration guide](./docs/migration_guide_v2.md) to help transition to the CLIv2.

Reach Us

We love feedback. Don't hesitate to open a Github issue or feel free to reach us on Scaleway Slack community, we are waiting for you on #opensource.