Skip to content

Commit

Permalink
Release v0.6.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Antti Myyrä committed Sep 25, 2023
1 parent 71bbd1b commit 6b4bca7
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 11 deletions.
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

---

## [0.6.0] - 2023-09-25

### Added

- Inventory support for filtering with server labels and server groups

### Changed

- Servers that are not reachable with matching `connect_with` option are skipped, instead of returning an error.

## [0.5.1] - 2021-10-19

### Changed
Expand Down
22 changes: 12 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Ansible UpCloud Collection


[![sanity](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/sanity-test.yml/badge.svg)](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/sanity-test.yml)
[![unit](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/unit-tests.yml)
[![Ansible sanity tests](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/sanity-test.yml/badge.svg)](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/sanity-test.yml)
[![unit tests](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/UpCloudLtd/upcloud-ansible-collection/actions/workflows/unit-tests.yml)

UpCloud inventory as a modernized Ansible collection. Current scope only covers UpCloud's servers offering,
but depending on the demand we might include our other services (networks, (object) storages, routers, databases etc)
Expand All @@ -18,17 +18,17 @@ sections below for development quickstart if you're interested in adding new fea

### Prerequisites

UpCloud Collection requires [UpCloud API's Python bindings](https://pypi.org/project/upcloud-api/) version 2.0.0 or
UpCloud Collection requires [UpCloud API's Python bindings](https://pypi.org/project/upcloud-api/) version 2.5.0 or
newer in order to work. It can be installed from the Python Package Index with the `pip` tool:

```bash
pip3 install upcloud-api>=2.0.0
pip3 install upcloud-api>=2.5.0
```

The collection itself can be installed with the `ansible-galaxy` command that comes with the Ansible package:

```bash
ansible-galaxy collection install https://github.com/UpCloudLtd/upcloud-ansible-collection/releases/download/v0.5.1/community-upcloud-0.5.1.tar.gz
ansible-galaxy collection install https://github.com/UpCloudLtd/upcloud-ansible-collection/releases/download/v0.6.0/community-upcloud-0.6.0.tar.gz
```

### Inventory usage
Expand All @@ -54,10 +54,10 @@ export UPCLOUD_PASSWORD="verysecretpassword"
And show the Ansible inventory information as a graph:

```bash
ansible-inventory -i upcloud.yml --graph
ansible-inventory -i upcloud.yml --graph --vars
```

You should see a list of hosts.
You should see a list of hosts and their host variables you can use in playbooks.

#### Further examples

Expand All @@ -67,12 +67,14 @@ You can filter based on multiple data points:
plugin: community.upcloud.upcloud
zones:
- fi-hel2
tags:
- app
- db
labels:
- role=prod
- foo
states:
- started
connect_with: private_ipv4
network: 035a0a8a-7704-4da5-820d-129fc8232714
server_group: Group name or UUID
```
Servers can also be grouped by status, zone etc by specifying them as `keyed_groups`.
Expand Down
2 changes: 1 addition & 1 deletion galaxy.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
namespace: community
name: upcloud
version: 0.5.1
version: 0.6.0
readme: README.md
authors:
- UpCloud developers (github.com/UpCloudLtd)
Expand Down

0 comments on commit 6b4bca7

Please sign in to comment.