Skip to content

Commit

Permalink
Reviewed README.md.
Browse files Browse the repository at this point in the history
  • Loading branch information
Adrien Delle Cave committed Aug 28, 2019
1 parent 3ea2428 commit 3a82539
Show file tree
Hide file tree
Showing 5 changed files with 33 additions and 19 deletions.
34 changes: 18 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,9 @@ For example, you can use auton from CI/CD to run on remote servers, you just nee
- [ansible](https://github.com/ansible/ansible)
- [curl](https://github.com/curl/curl)
- [terraform](https://github.com/hashicorp/terraform)
You can also use auton if you need to execute a new version of a software but you can't install it on a legacy server.

You can also use auton if you need to execute a new version of a software but you can't install it on a legacy server
or tests programs execution.

## Quickstart

Expand Down Expand Up @@ -87,15 +89,15 @@ endpoints:

### Authentication

To enable authentication, you must add `auth_basic` and `auth_basic_file` lines in section general:
To enable authentication, you must add `auth_basic` and `auth_basic_file` lines in section `general`:

```yaml
general:
auth_basic: 'Restricted'
auth_basic_file: '/etc/auton/auton.passwd'
```

To generate `auth_basic_file` use `htpasswd`:
Use `htpasswd` to generate `auth_basic_file`:

`htpasswd -c -s /etc/auton/auton.passwd foo`

And you have to add for each modules route `auth: true`:
Expand Down Expand Up @@ -139,7 +141,17 @@ Use section `users` to specify users allowed by endpoint:

#### Plugin subproc

subproc plugin executes programs with subprocess.
subproc plugin executes programs with python `subprocess`.

Predefined AUTON environment variables during execution:

| Variable | Description |
|:-------------------|:----------------------------------------------|
| `AUTON` | Mark the job is executed in AUTON environment |
| `AUTON_JOB_TIME` | Current time in local time zone |
| `AUTON_JOB_GMTIME` | Current time in GMT |
| `AUTON_JOB_UID` | Current job uid passed from client |
| `AUTON_JOB_UUID` | Unique ID of the current job |

Use keyword `proc` to specify program path:
```yaml
Expand Down Expand Up @@ -286,16 +298,6 @@ endpoints:
disallow-env: true
```

Predefined AUTON environment variables during execution:

| Variable | Description |
|:-------------------|:----------------------------------------------|
| `AUTON` | Mark the job is executed in AUTON environment |
| `AUTON_JOB_TIME` | Current time in local time zone |
| `AUTON_JOB_GMTIME` | Current time in GMT |
| `AUTON_JOB_UID` | Current job uid passed from client |
| `AUTON_JOB_UUID` | Unique ID of the current job |

## Auton command-lines

#### endpoint curl examples:
Expand Down Expand Up @@ -330,7 +332,7 @@ Add arguments files to send local files:

Add multiple arguments:

`auton --endpoint curl --uri http://localhost:8666 --multi-args '-vvv -u foo:bar https://example.com' --multi-argsfiles '-d@=foo.txt -d@=bar.txt --cacert=cacert.pem'`
`auton --endpoint curl --uri http://localhost:8666 --multi-args '-vvv -u foo:bar https://example.com' --multi-argsfiles '-d@=somedir/foo.txt -d@=bar.txt --cacert=cacert.pem'`

Get file contents from stdin with `-`:

Expand Down
2 changes: 1 addition & 1 deletion bin/auton
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ __license__ = """
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
"""
__version__ = '0.1.47'
__version__ = '0.1.49'

import argparse
import os
Expand Down
2 changes: 1 addition & 1 deletion bin/autond
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ __license__ = """
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
"""
__version__ = '0.1.47'
__version__ = '0.1.49'

import argparse
import logging
Expand Down
12 changes: 12 additions & 0 deletions debian/changelog
Original file line number Diff line number Diff line change
@@ -1,3 +1,15 @@
auton (0.1.49) unstable; urgency=medium

* Reviewed README.md.

-- Adrien DELLE CAVE <adrien.delle.cave@commandersact.com> Wed, 28 Aug 2019 15:18:24 +0200

auton (0.1.48) unstable; urgency=medium

* Reviewed README.md.

-- Adrien DELLE CAVE <adrien.delle.cave@commandersact.com> Wed, 28 Aug 2019 15:13:42 +0200

auton (0.1.47) unstable; urgency=medium

* Reviewed README.md.
Expand Down
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
import os
from setuptools import find_packages, setup

version = '0.1.47'
version = '0.1.49'

current_dir = os.path.abspath(os.path.dirname(__file__))

Expand Down

0 comments on commit 3a82539

Please sign in to comment.