# remotes role for Ansible

Interact with remote services

## Role Variables

### Default variables

* `remotes_packages` - List of packages to install/remove on your hosts

``` yaml
remotes_packages:
- { "name": "remoteit", "state": "present" }
```

* `remotes_pips` - List of python pip packages to install/remove on your hosts

``` yaml
remotes_pips:
- { "name": "awscli", "state": "present" }
- { "name": "docker", "state": "present" }
```

* `remotes_services` - List of services to enable/disable on your hosts

``` yaml
remotes_services:
- { "name": "connectd", "state": "started", "enabled": "yes" }
```

### AWS variables

* `aws_access_key_id` - aws_access_key_id to add in ~/.aws/credentials

``` yaml
aws_access_key_id: 'YOUR_ACCESS_KEY_ID'
```

* `aws_group` - Set group of aws configuration files to `aws_group`

``` yaml
aws_group: 'root'
```

* `aws_output` - output to add in ~/.aws/config

``` yaml
aws_output: json
```

* `aws_region` - region to add in ~/.aws/config

``` yaml
aws_region: 'eu-west-1'
```

* `aws_secret_access_key` - aws_secret_access_key to add in ~/.aws/credentials

``` yaml
aws_secret_access_key: 'YOUR_SECRET_ACCESS_KEY'
```

* `aws_user` - Set owner of aws configuration files to `aws_user`

``` yaml
aws_user: 'root'
```

### Git variables

* `git_repositories` - Clone git repositories

``` yaml
git_repositories:
- { "repo": "https://github.com/aynicos/myos", "dest": "/dns/com/github/aynicos/myos", "key_file": "~/.ssh/id_rsa", "version": "master" }
```

## Example playbook

``` yaml
- hosts: 'remotes'
  roles:
  - role: 'aynicos.remotes'
    aws_access_key_id: 'YOUR_ACCESS_KEY_ID'
    aws_secret_access_key: 'YOUR_SECRET_ACCESS_KEY'
```