From 909f102f1735c3ccebba569ebd3e6ee7a10ab44b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Mon, 2 Dec 2024 16:53:10 +0000 Subject: [PATCH 1/8] Make Readme proper markdown file + cosmetics - rename README - improve wording in documentation --- README => README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) rename README => README.md (81%) diff --git a/README b/README.md similarity index 81% rename from README rename to README.md index 18fb59b..0ae1805 100644 --- a/README +++ b/README.md @@ -1,13 +1,14 @@ # Ivynet Client installation -The role installs ivynet client binary in an Ubuntu OS. -Additionally it install Docker CE. +The role installs ivynet client binary file in Linux and ensure it's in global PATH. +Additionally, Ansible installs Docker CE (first adding matching package repository). ## Supported systems Ivynet client should work with any Linux distribution which has the libssl3 and libcrypto libraries. The role has a set of simple molecule tests confirming that it works with contemporary distributions: + - Debian (12), - Ubuntu (22.04, 24.04), - RedHat derivatives (Rocky Linux 9), From 6cc24a862eb5614bc3d5de3d525716a9e2b3fb78 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Mon, 2 Dec 2024 22:45:46 +0000 Subject: [PATCH 2/8] Add example of playbook --- README.md | 13 +++++++++++++ defaults/main.yml | 2 +- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0ae1805..1b699bf 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,19 @@ The role installs ivynet client binary file in Linux and ensure it's in global PATH. Additionally, Ansible installs Docker CE (first adding matching package repository). +# Quick start + +* Install [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-and-upgrading-ansible) +* Prepare an inventory file +* Prepare playbook e.g. +``` +--- +name: Install IvyNet client + hosts: all + roles: + - ivynet-client-ansible +``` + ## Supported systems Ivynet client should work with any Linux distribution which has the libssl3 and libcrypto libraries. diff --git a/defaults/main.yml b/defaults/main.yml index 940ff6b..6c0aa9e 100644 --- a/defaults/main.yml +++ b/defaults/main.yml @@ -6,7 +6,7 @@ ivynet_client_bucket: "https://storage.googleapis.com/ivynet-share" ivynet_client_install_path: "/opt/ivynet" # Version of the file -ivynet_client_version: "0.3.0" +ivynet_client_version: "0.3.1" # Name of the file ivynet_client_file: "ivynet" From a8a34c217fe2104b48cda8946ccbc1210502c499 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Mon, 2 Dec 2024 22:52:26 +0000 Subject: [PATCH 3/8] Better name for a task --- molecule/default/verify.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/molecule/default/verify.yml b/molecule/default/verify.yml index 00a4f68..6281ee9 100644 --- a/molecule/default/verify.yml +++ b/molecule/default/verify.yml @@ -18,14 +18,13 @@ - ivynet_bin.stat.isreg is defined - ivynet_bin.stat.isreg == True - ivynet_bin.stat.size > 2**20 - - name: Confirm right version + - name: Check if version printed out ansible.builtin.shell: cmd: | set -o pipefail && {{ ivynet_client_path }} -V | grep -qE "ivy\ [0-9]+(\.[0-9]+){2}" executable: /bin/bash - register: ivynet_version_check changed_when: ivynet_version_check.rc != 0 From 66c5b45a26e9082a5ca53c80bd970b43eaf203d2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Tue, 3 Dec 2024 17:26:00 +0000 Subject: [PATCH 4/8] Add version in the example --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 1b699bf..48fc308 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,9 @@ Additionally, Ansible installs Docker CE (first adding matching package reposito --- name: Install IvyNet client hosts: all + become: true + vars: + ivynet_client_version: 0.3.2 roles: - ivynet-client-ansible ``` From 85846253b3b7035a84c406a68b0ece3ce3da2a15 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Wed, 4 Dec 2024 12:55:56 +0000 Subject: [PATCH 5/8] Bump version --- defaults/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/defaults/main.yml b/defaults/main.yml index 6c0aa9e..00ea0c9 100644 --- a/defaults/main.yml +++ b/defaults/main.yml @@ -6,7 +6,7 @@ ivynet_client_bucket: "https://storage.googleapis.com/ivynet-share" ivynet_client_install_path: "/opt/ivynet" # Version of the file -ivynet_client_version: "0.3.1" +ivynet_client_version: "0.3.3" # Name of the file ivynet_client_file: "ivynet" From f2642b9e2b37f585488e9de421d9c968948b6f39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Wed, 4 Dec 2024 12:57:46 +0000 Subject: [PATCH 6/8] Minor adjustments to Readme --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 48fc308..8a72e3b 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ The role installs ivynet client binary file in Linux and ensure it's in global PATH. Additionally, Ansible installs Docker CE (first adding matching package repository). +For more information about the Ivynet Client visit [here](https://docs.ivynet.dev/docs/client/clientExplanation). + # Quick start * Install [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-and-upgrading-ansible) @@ -10,11 +12,11 @@ Additionally, Ansible installs Docker CE (first adding matching package reposito * Prepare playbook e.g. ``` --- -name: Install IvyNet client +- name: Install IvyNet client hosts: all become: true vars: - ivynet_client_version: 0.3.2 + ivynet_client_version: 0.3.3 roles: - ivynet-client-ansible ``` From a49e7d3e778e24d5e12679fa45c3e9e0c0d1c9f4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Wed, 18 Dec 2024 11:09:33 +0000 Subject: [PATCH 7/8] Bump the version --- defaults/main.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/defaults/main.yml b/defaults/main.yml index 00ea0c9..4658976 100644 --- a/defaults/main.yml +++ b/defaults/main.yml @@ -6,7 +6,7 @@ ivynet_client_bucket: "https://storage.googleapis.com/ivynet-share" ivynet_client_install_path: "/opt/ivynet" # Version of the file -ivynet_client_version: "0.3.3" +ivynet_client_version: "0.4.3" # Name of the file ivynet_client_file: "ivynet" From 48d07845b65e56bdb097db5bbd25327c538f62be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wawrzyniec=20=27Wawrzek=27=20Niewodnicza=C5=84ski?= Date: Wed, 18 Dec 2024 19:21:38 +0000 Subject: [PATCH 8/8] Small changes --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8a72e3b..1673499 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ # Ivynet Client installation -The role installs ivynet client binary file in Linux and ensure it's in global PATH. +The role installs ivynet client binary file in Linux and ensure it's in the global PATH. Additionally, Ansible installs Docker CE (first adding matching package repository). -For more information about the Ivynet Client visit [here](https://docs.ivynet.dev/docs/client/clientExplanation). +For more information about the Ivynet Client visit [here](https://docs.ivynet.dev/). # Quick start @@ -16,7 +16,7 @@ For more information about the Ivynet Client visit [here](https://docs.ivynet.de hosts: all become: true vars: - ivynet_client_version: 0.3.3 + ivynet_client_version: 0.4.3 roles: - ivynet-client-ansible ``` @@ -42,7 +42,7 @@ Molecule checks that: # Known issue -- Molecule does not work with Apple Silicon (at least MacOS on it) +- Molecule does not work with Apple Silicon (at least with MacOS on it) -- Fedora 41 causes an issue for Ansible dnf module (https://github.com/ansible/ansible/issues/84206). +- Fedora 41 is an issue for Ansible dnf module (https://github.com/ansible/ansible/issues/84206). That causes the role to fail on docker package installation.