Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/githubixx/ansible-role-cilium-cli
Ansible role to install cilium command line (CLI) utility
https://github.com/githubixx/ansible-role-cilium-cli
ansible ansible-role ansible-roles cilium cli
Last synced: 2 months ago
JSON representation
Ansible role to install cilium command line (CLI) utility
- Host: GitHub
- URL: https://github.com/githubixx/ansible-role-cilium-cli
- Owner: githubixx
- License: gpl-3.0
- Created: 2021-08-03T20:31:36.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-04T17:22:36.000Z (4 months ago)
- Last Synced: 2024-10-20T08:24:42.883Z (4 months ago)
- Topics: ansible, ansible-role, ansible-roles, cilium, cli
- Homepage:
- Size: 43 KB
- Stars: 2
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ansible-role-cilium-cli
Installs [cilium command line](https://github.com/cilium/cilium-cli/) utility.
## Versions
I tag every release and try to stay with [semantic versioning](http://semver.org). If you want to use the role I recommend to checkout the latest tag. The master branch is basically development while the tags mark stable releases. But in general I try to keep master in good shape too. A tag `2.8.1+0.16.19` means this is release `2.8.1` of this role and it uses `cilium` CLI version `0.16.19`. If the role itself changes `X.Y.Z` before `+` will increase. If the `cilium` CLI version changes `X.Y.Z` after `+` will increase too. This allows to tag bugfixes and new major versions of the role while it's still developed for a specific `cilium` CLI release.
## Changelog
see [CHANGELOG.md](https://github.com/githubixx/ansible-role-cilium-cli/blob/master/CHANGELOG.md)
## Role Variables
```yaml
---
# "cilium" CLI version to install
cilium_cli_version: "0.16.19"
# Where to install "cilium" binary. This directory will only be created if
# "cilium_cli_bin_directory_owner" and "cilium_cli_bin_directory_group variables
# are also defined! Otherwise it will be assumend that the destination directory
# already exits with proper permissions.
cilium_cli_bin_directory: "/usr/local/bin"
# If the "cilium" binary should be placed in a directory that doesn't exist yet,
# this two variables have to be specified to set owner and group of that new
# directory accordingly.
# cilium_cli_bin_directory_owner: "root"
# cilium_cli_bin_directory_group: "root"
# Specifies the permissions of the destination directory.
cilium_cli_bin_directory_mode: "0755"
# Directory to store the cilium cli archive.
cilium_cli_tmp_directory: "{{ lookup('env', 'TMPDIR') | default('/tmp',true) }}"
# Owner/group of "cilium" binary.
cilium_cli_owner: "root"
cilium_cli_group: "root"
# Specifies the permissions of the "cilium" binary.
cilium_cli_binary_mode: "0755"
# Operarting system on which "cilium" should run on.
# Use "darwin" for MacOS X
cilium_cli_os: "linux"
# Processor architecture "cilium" should run on.
# Other possible values: "386","arm64","arm"
cilium_cli_arch: "amd64"
# Name of the archive file name.
cilium_cli_archive: "cilium-{{ cilium_cli_os }}-{{ cilium_cli_arch }}.tar.gz"
# The cilium CLI download URL (normally no need to change it).
cilium_cli_url: "https://github.com/cilium/cilium-cli/releases/download/v{{ cilium_cli_version }}/{{ cilium_cli_archive }}"
```
## Example Playbook
Example 1 (without role tag):
```yaml
- hosts: your-host
roles:
- githubixx.cilium_cli
```
Example 2 (assign tag to role):
```yaml
-
hosts: your-host
roles:
-
role: githubixx.cilium_cli
tags: role-cilium-cli
```
## Testing
This role has a small test setup that is created using [Molecule](https://github.com/ansible-community/molecule), libvirt (vagrant-libvirt) and QEMU/KVM. Please see my blog post [Testing Ansible roles with Molecule, libvirt (vagrant-libvirt) and QEMU/KVM](https://www.tauceti.blog/posts/testing-ansible-roles-with-molecule-libvirt-vagrant-qemu-kvm/) how to setup. The test configuration is [here](https://github.com/githubixx/ansible-role-cilium-cli/tree/master/molecule/default).
Afterwards molecule can be executed:
```bash
molecule converge
```
This will setup a few virtual machines (VM) with different supported Linux operating systems and installs `cilium_cli` role.
To run a small test if `cilium` command was successfully install run:
```bash
molecule verify
```
To clean up run
```bash
molecule destroy
```
## License
GNU GENERAL PUBLIC LICENSE Version 3
## Author Information
[http://www.tauceti.blog](http://www.tauceti.blog)