selectel-mks-cli: CLI for the Selectel Managed Kubernetes Service

CLI to the Selectel MKS V1 API.

Installation

Download a binary for the needed platform from the releases page.

Usage

You need to specify two mandatory parameters to use CLI:

• MKS endpoint that can be specified by the --mks-endpoint option or MKS_ENDPOINT environment variable;
• MKS project-scoped token that can be specified by the --mks-token option or MKS_TOKEN environment variable.

You can use help command to see all available subcommands:

$ mks help
mks 0.1.0

USAGE:
    mks [FLAGS] --mks-endpoint <mks-endpoint> --mks-token <mks-token> <SUBCOMMAND>

FLAGS:
    -d, --debug      Activate debug mode
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v, --verbose    Activate verbose mode

OPTIONS:
        --mks-endpoint <mks-endpoint>    MKS endpoint [env: MKS_ENDPOINT]
        --mks-token <mks-token>          MKS project-scoped token [env: MKS_TOKEN]

SUBCOMMANDS:
    cluster        Cluster commands
    help           Prints this message or the help of the given subcommand(s)
    kubeversion    Kubeversion commands
    node           Node commands
    nodegroup      Nodegroup commands
    task           Task commands

You can also use help with any subcommand to see all available nested subcommands and their options:

$ mks help nodegroup
mks-nodegroup 0.1.0
Nodegroup commands

USAGE:
    mks nodegroup <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

SUBCOMMANDS:
    create    Create a new nodegroup
    delete    Delete nodegroup
    get       Get cluster nodegroup
    help      Prints this message or the help of the given subcommand(s)
    list      List cluster nodegroups
    set       Set nodegroup parameters

$ mks help nodegroup set
mks-nodegroup-set 0.1.0
Set nodegroup parameters

USAGE:
    mks nodegroup set [OPTIONS] <nodegroup-id> --cluster-id <cluster-id>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
        --cluster-id <cluster-id>      Cluster identifier
        --nodes-count <nodes-count>    Count of nodes

ARGS:
    <nodegroup-id>    Nodegroup identifier

How to get available values for mks-endpoint option

There are separate endpoints for each MKS region:

ru-1: https://ru-1.mks.selcloud.ru/v1
ru-2: https://ru-2.mks.selcloud.ru/v1
ru-3: https://ru-3.mks.selcloud.ru/v1
ru-7: https://ru-7.mks.selcloud.ru/v1
ru-8: https://ru-8.mks.selcloud.ru/v1

You can get available endpoints from the endpoint catalog in the Selectel Cloud.

How to get mks-token value

You can see this token in your web-browser console when working with the Selectel Cloud API.
You can also create this token with Terraform, Go library or Python library/CLI.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.