Skip to content

RiveryIO/rivery_cli

Repository files navigation

Overview

Rivery CLI is an amazing way to manage, deploy, run and edit rivers inside Rivery. The rivers are configured only by .yaml files, as a configuration files, makes this CLI as a basic of Infrastructure As Code (IaC) methodology.

In order to start using the tool, go to the Getting Started page.

Getting started

Requirements

  1. You must have Python 3.6 or later installed. For installation instructions, see the Downloading Python page in Python's Beginner Guide.

  2. An API Token with the following scopes:

    * me:list
    * river:execute
    * river:edit
    * river:list
    * river:delete
    * connection:edit
    * connection:list
    * connection:delete

In order to create a new API token, please refer to our docs

Install

Install Rivery CLI, by using the next command:

pip install -U rivery-cli

Initiate a new project

in order to start new project:

  1. create new project directory, for example in linux base OS:
> mkdir /home/my-project

or in windows:

> mkdir c:\my-project
  1. Go into the my-project directory you've created: cd my-project
  2. run the next command and choose your project name.
> rivery init

Create the first profile

Rivery CLI store defaults and credentials under an "entity" called profile.

Each profile has its name and the configurations under it. Due to every API token refers to specific account+environment inside your Rivery console, and every account+environment pair has its own credentials, it is likely you'll have a profile per each account+environment coupling.

For creating your first profile use the next command:

> rivery configure

And Follow the prompt:

> Please enter your token. (******): ...
> Choose your Region () [...]: ...
> Thank you for entering auth credentials. 
> Please check your profile at: ~/.rivery/auth

And you're good to go!

Issues and Feature Requests

Rivery CLI and IaC engine is fully open source dir. We're getting in warm welcome any issues/features submitted to our end, and encourage the community to contribute in the solution. Please don't hesitate to add any issues/feature request using the repo's Issues section.

Getting start With Rivery

You can check out our product docs at https://docs.rivery.io in order to getting started.

Full documentation

You may find here the full documentation.