portainer-cli

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 26 Open GitHub ↗

Command line interface to easy communicate to your Portainer application.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Portainer CLI

Portainer CLI is a Python software to use in command line. Use this command line interface to easy communicate with your [Portainer](https://portainer.io/) application, like in a continuous integration and continuous deployment environments.

## Install

```
pip install [--user] portainer-cli
```

## Usage

### Global flags

### configure command

Configure Portainer HTTP service base url.

```bash
portainer-cli configure base_url
```

**E.g:**

```bash
portainer-cli configure http://10.0.0.1:9000/
```

### login command

Identify yourself and take action.

```bash
portainer-cli login username password
```

**E.g:**

```bash
portainer-cli login douglas d1234
```

### create_stack command

Create a stack.

```bash
portainer-cli create_stack -n stack_name -e endpoint_id -sf stack_file
```

**E.g:**

```bash
portainer-cli create_stack -n stack_name -e 1 stack-test -sf docker-compose.yml
```

#### Flags

### update_stack command

Update a stack.

```bash
portainer-cli update_stack -s stack_id -e endpoint_id -sf stack_file
```

**E.g:**

```bash
portainer-cli update_stack -s 18 -e 1 -sf docker-compose.yml
```

#### Environment variables arguments

```bash
portainer-cli update_stack id -s stack_id -e endpoint_id -sf stack_file --env.var=value
```

Where `var` is the environment variable name and `value` is the environment variable value.

#### Flags

### create_or_update_stack command

Create or update a stack based on it's name.

```bash
portainer-cli create_or_update_stack -n stack_name -e endpoint_id -sf stack_file
```

**E.g:**

```bash
portainer-cli update_stack -s 18 -e 1 -sf docker-compose.yml
```

#### Environment variables arguments

```bash
portainer-cli create_or_update_stack -n stack_name -e endpoint_id -sf stack_file --env.var=value
```

Where `var` is the environment variable name and `value` is the environment variable value.

#### Flags

### update_stack_acl command

Update acl associated to a stack

```bash
portainer-cli update_stack_acl -s stack_id -e endpoint_id -o ownership_type
```

Remark : you can either update by stack_id or stack_name (`-s` or `-n`)

**E.g:**

```bash
portainer-cli update_stack_acl -n stack-test -e 1 -o restricted -u user1,user2 -t team1,team2
```

#### Flags

### get_stack_id command

Get stack id by it's name. return -1 if the stack does not exist

```bash
portainer-cli get_stack_id -n stack_name -e endpoint_id
```

**E.g:**

```bash
portainer-cli get_stack_id -n stack-test -e 1
```

#### Flags

### update_registry command

Update registry.

```bash
portainer-cli update_registry id [-name] [-url]
```

**E.g:**

```bash
portainer-cli update_registry 1 -name="Some registry" -url="some.url.com/r"
```

#### Authentication

You can use authentication passing `-a` or `--authentication` flag, but you must pass the `-username` and `-password` options.

```bash
portainer-cli update_registry 1 -a -username=douglas -password=d1234
```

### request command

Make a request.

```bash
portainer-cli request path [method=GET] [data]
```

**E.g:**

```bash
portainer-cli request status
```

#### Flags

## Development

This project use [Pipenv](https://pipenv.readthedocs.io/en/latest/) to manager Python packages.

With Pipenv installed, run `make install` to install all development packages dependencies.

Run `make lint` to run [flake8](http://flake8.pycqa.org/en/latest/) following PEP8 rules.

Run `make` or `make sdist` to create/update `dist` directory.

portainer-cli

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README