Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ngine-io/ansible-role-vultr
Ansible Role for Vultr using vultr.cloud collection
https://github.com/ngine-io/ansible-role-vultr
ansible ansible-role ansible-roles vultr
Last synced: 9 days ago
JSON representation
Ansible Role for Vultr using vultr.cloud collection
- Host: GitHub
- URL: https://github.com/ngine-io/ansible-role-vultr
- Owner: ngine-io
- License: mit
- Created: 2022-12-17T17:24:56.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-11T16:05:57.000Z (about 1 year ago)
- Last Synced: 2024-11-22T18:58:58.649Z (2 months ago)
- Topics: ansible, ansible-role, ansible-roles, vultr
- Homepage: https://galaxy.ansible.com/ngine_io/vultr_cloud
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Role: Vultr Cloud
[](https://github.com/ngine-io/ansible-role-vultr/actions?query=workflow%3ACI)
Manages compute resources on [Vultr Cloud](https://www.vultr.com/).
## Role Variables
See [defaults/main.yml](https://github.com/ngine-io/ansible-role-vultr/blob/main/defaults/main.yml)
## Dependencies
See [requirements.txt](https://github.com/ngine-io/ansible-role-vultr/blob/main/requirements.txt) and [requirements.yml](https://github.com/ngine-io/ansible-role-vultr/blob/main/requirements.yml)
## Examples
### Playbook
A typical playbook would look like this.
```yaml
---
- name: Provision Cloud servers
hosts: all
serial: 5
gather_facts: false
roles:
- role: ngine_io.vultr_cloud
delegate_to: localhost
post_tasks:
- name: Wait for SSH access
delegate_to: localhost
wait_for:
host: "{{ ansible_host }}"
port: 22
timeout: 600
```
### Common Configurations
Typical common configs in a top level group (e.g. `group_vars/all.yml`):
```yaml
# file: group_vars/all.yml
# API: creds
vultr__api_key: "..."
# Regoin: default ewr
vultr__region: ams
vultr__instance_os: "Rocky Linux 9 x64"
# Enable IPv6
vultr__instance_ipv6_enabled: true
vultr__firewall_groups:
- name: proxy
rules:
- cidr: 0.0.0.0/0
port: "443"
- cidr: 0.0.0.0/0
port: "80"
- cidr: 1.2.3.4/32
port: "8000:8999"
# Create a private networks for backend access.
vultr__vpcs:
- name: default
cidr: "10.99.1.0/24"
```
### Instances config via Group / Host Vars
Assuming an inventory similar to the following:
```ini
[proxy]
proxy1.example.com
proxy2.example.com
[cassandra]
cassandra1.example.com
cassandra2.example.com
cassandra3.example.com
```
#### Proxy Group Vars
Ensure all proxy instances use a different offering and the additional security group proxy:
```yaml
#file: group_vars/proxy.yml
# Default: vc2-1c-1gb
vultr__instance_plan: vc2-4c-8gb
# Assign firewall groups the instances (default: [default])
vultr__firewall_groups:
- default
- proxy
# Attach VPCs to the intances
vultr__instance_vpcs:
- default
```
#### Cassandra Group Vars
```yaml
#file: group_vars/cassandra.yml
# Use CPU related offering
vultr__instance_plan: vhf-6c-24gb
# Attach VPCs to the intances
vultr__instance_vpcs:
- default
```
----
> :information_source: **HINT**: get a list of available optons using the vultr cli.
> See https://github.com/vultr/vultr-cli.
----
## License
MIT
## Author Information
René Moser (@resmo)