From 0c4220b42d7d26c59ddce59d212b93b4e2b82dcc Mon Sep 17 00:00:00 2001 From: Hunter Gerlach Date: Thu, 22 Jun 2023 09:30:30 -0400 Subject: [PATCH 1/6] Add guidance for using Workspace badge button --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index f879897..a2bf7c6 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,4 @@ +To get started, simply click the button below... [![Contribute](https://www.eclipse.org/che/contribute.svg)](https://workspaces.openshift.com/f?url=https://github.com/kyetter/demo/) # Ansible Development on OpenShift DevSpaces From 84cef0856ce768e77edd426d7b3f1c49448fe072 Mon Sep 17 00:00:00 2001 From: Hunter Gerlach Date: Thu, 22 Jun 2023 09:30:53 -0400 Subject: [PATCH 2/6] Improve formatting --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index a2bf7c6..a327ac3 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ To get started, simply click the button below... + [![Contribute](https://www.eclipse.org/che/contribute.svg)](https://workspaces.openshift.com/f?url=https://github.com/kyetter/demo/) # Ansible Development on OpenShift DevSpaces From 2320ba6f0e5a5ba422b2e13f8b545418c8dcba70 Mon Sep 17 00:00:00 2001 From: kyetter Date: Mon, 18 Sep 2023 10:25:13 -0400 Subject: [PATCH 3/6] merging README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5a9ebb1..0edc6e7 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ To get started, simply click the button below... -[![Contribute](https://www.eclipse.org/che/contribute.svg)](https://workspaces.openshift.com/f?url=https://github.com/kyetter/demo/) +[![Contribute](https://www.eclipse.org/che/contribute.svg)](https://workspaces.openshift.com/f?url=https://github.com/devspaces-samples/ansible-devspaces-demo) + # Ansible Development on OpenShift DevSpaces From 40a82f1f8a5c8a58333f170627bdbe3260dcfa96 Mon Sep 17 00:00:00 2001 From: kyetter Date: Tue, 19 Sep 2023 10:36:00 -0400 Subject: [PATCH 4/6] initial commit --- collections/example/collection/README.md | 3 + collections/example/collection/galaxy.yml | 69 +++++++++++++++++++ .../example/collection/meta/runtime.yml | 52 ++++++++++++++ .../example/collection/plugins/README.md | 31 +++++++++ .../collection/roles}/backup_file/.yamllint | 0 .../collection/roles}/backup_file/README.md | 0 .../roles}/backup_file/defaults/main.yml | 0 .../roles}/backup_file/handlers/main.yml | 0 .../roles}/backup_file/meta/main.yml | 0 .../backup_file/molecule/default/INSTALL.rst | 0 .../backup_file/molecule/default/converge.yml | 0 .../backup_file/molecule/default/create.yml | 0 .../backup_file/molecule/default/destroy.yml | 0 .../backup_file/molecule/default/molecule.yml | 0 .../backup_file/molecule/default/prepare.yml | 0 .../molecule/default/templates/deployment.yml | 0 .../backup_file/molecule/default/verify.yml | 0 .../roles}/backup_file/requirements.yml | 0 .../roles}/backup_file/tasks/main.yml | 0 .../roles}/backup_file/tests/inventory | 0 .../roles}/backup_file/tests/test.yml | 0 .../roles}/backup_file/vars/main.yml | 0 22 files changed, 155 insertions(+) create mode 100644 collections/example/collection/README.md create mode 100644 collections/example/collection/galaxy.yml create mode 100644 collections/example/collection/meta/runtime.yml create mode 100644 collections/example/collection/plugins/README.md rename {roles => collections/example/collection/roles}/backup_file/.yamllint (100%) rename {roles => collections/example/collection/roles}/backup_file/README.md (100%) rename {roles => collections/example/collection/roles}/backup_file/defaults/main.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/handlers/main.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/meta/main.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/INSTALL.rst (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/converge.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/create.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/destroy.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/molecule.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/prepare.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/templates/deployment.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/molecule/default/verify.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/requirements.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/tasks/main.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/tests/inventory (100%) rename {roles => collections/example/collection/roles}/backup_file/tests/test.yml (100%) rename {roles => collections/example/collection/roles}/backup_file/vars/main.yml (100%) diff --git a/collections/example/collection/README.md b/collections/example/collection/README.md new file mode 100644 index 0000000..7de42a2 --- /dev/null +++ b/collections/example/collection/README.md @@ -0,0 +1,3 @@ +# Ansible Collection - example.collection + +Documentation for the collection. diff --git a/collections/example/collection/galaxy.yml b/collections/example/collection/galaxy.yml new file mode 100644 index 0000000..ad092a7 --- /dev/null +++ b/collections/example/collection/galaxy.yml @@ -0,0 +1,69 @@ +### REQUIRED +# The namespace of the collection. This can be a company/brand/organization or product namespace under which all +# content lives. May only contain alphanumeric lowercase characters and underscores. Namespaces cannot start with +# underscores or numbers and cannot contain consecutive underscores +namespace: example + +# The name of the collection. Has the same character restrictions as 'namespace' +name: collection + +# The version of the collection. Must be compatible with semantic versioning +version: 1.0.0 + +# The path to the Markdown (.md) readme file. This path is relative to the root of the collection +readme: README.md + +# A list of the collection's content authors. Can be just the name or in the format 'Full Name (url) +# @nicks:irc/im.site#channel' +authors: +- your name + + +### OPTIONAL but strongly recommended +# A short summary description of the collection +description: your collection description + +# Either a single license or a list of licenses for content inside of a collection. Ansible Galaxy currently only +# accepts L(SPDX,https://spdx.org/licenses/) licenses. This key is mutually exclusive with 'license_file' +license: +- GPL-2.0-or-later + +# The path to the license file for the collection. This path is relative to the root of the collection. This key is +# mutually exclusive with 'license' +license_file: '' + +# A list of tags you want to associate with the collection for indexing/searching. A tag name has the same character +# requirements as 'namespace' and 'name' +tags: [] + +# Collections that this collection requires to be installed for it to be usable. The key of the dict is the +# collection label 'namespace.name'. The value is a version range +# L(specifiers,https://python-semanticversion.readthedocs.io/en/latest/#requirement-specification). Multiple version +# range specifiers can be set and are separated by ',' +dependencies: {} + +# The URL of the originating SCM repository +repository: http://example.com/repository + +# The URL to any online docs +documentation: http://docs.example.com + +# The URL to the homepage of the collection/project +homepage: http://example.com + +# The URL to the collection issue tracker +issues: http://example.com/issue/tracker + +# A list of file glob-like patterns used to filter any files or directories that should not be included in the build +# artifact. A pattern is matched from the relative path of the file or directory of the collection directory. This +# uses 'fnmatch' to match the files or directories. Some directories and files like 'galaxy.yml', '*.pyc', '*.retry', +# and '.git' are always filtered. Mutually exclusive with 'manifest' +build_ignore: [] + +# A dict controlling use of manifest directives used in building the collection artifact. The key 'directives' is a +# list of MANIFEST.in style +# L(directives,https://packaging.python.org/en/latest/guides/using-manifest-in/#manifest-in-commands). The key +# 'omit_default_directives' is a boolean that controls whether the default directives are used. Mutually exclusive +# with 'build_ignore' +# manifest: null + diff --git a/collections/example/collection/meta/runtime.yml b/collections/example/collection/meta/runtime.yml new file mode 100644 index 0000000..20f709e --- /dev/null +++ b/collections/example/collection/meta/runtime.yml @@ -0,0 +1,52 @@ +--- +# Collections must specify a minimum required ansible version to upload +# to galaxy +# requires_ansible: '>=2.9.10' + +# Content that Ansible needs to load from another location or that has +# been deprecated/removed +# plugin_routing: +# action: +# redirected_plugin_name: +# redirect: ns.col.new_location +# deprecated_plugin_name: +# deprecation: +# removal_version: "4.0.0" +# warning_text: | +# See the porting guide on how to update your playbook to +# use ns.col.another_plugin instead. +# removed_plugin_name: +# tombstone: +# removal_version: "2.0.0" +# warning_text: | +# See the porting guide on how to update your playbook to +# use ns.col.another_plugin instead. +# become: +# cache: +# callback: +# cliconf: +# connection: +# doc_fragments: +# filter: +# httpapi: +# inventory: +# lookup: +# module_utils: +# modules: +# netconf: +# shell: +# strategy: +# terminal: +# test: +# vars: + +# Python import statements that Ansible needs to load from another location +# import_redirection: +# ansible_collections.ns.col.plugins.module_utils.old_location: +# redirect: ansible_collections.ns.col.plugins.module_utils.new_location + +# Groups of actions/modules that take a common set of options +# action_groups: +# group_name: +# - module1 +# - module2 diff --git a/collections/example/collection/plugins/README.md b/collections/example/collection/plugins/README.md new file mode 100644 index 0000000..34cd30a --- /dev/null +++ b/collections/example/collection/plugins/README.md @@ -0,0 +1,31 @@ +# Collections Plugins Directory + +This directory can be used to ship various plugins inside an Ansible collection. Each plugin is placed in a folder that +is named after the type of plugin it is in. It can also include the `module_utils` and `modules` directory that +would contain module utils and modules respectively. + +Here is an example directory of the majority of plugins currently supported by Ansible: + +``` +└── plugins + ├── action + ├── become + ├── cache + ├── callback + ├── cliconf + ├── connection + ├── filter + ├── httpapi + ├── inventory + ├── lookup + ├── module_utils + ├── modules + ├── netconf + ├── shell + ├── strategy + ├── terminal + ├── test + └── vars +``` + +A full list of plugin types can be found at [Working With Plugins](https://docs.ansible.com/ansible-core/2.14/plugins/plugins.html). diff --git a/roles/backup_file/.yamllint b/collections/example/collection/roles/backup_file/.yamllint similarity index 100% rename from roles/backup_file/.yamllint rename to collections/example/collection/roles/backup_file/.yamllint diff --git a/roles/backup_file/README.md b/collections/example/collection/roles/backup_file/README.md similarity index 100% rename from roles/backup_file/README.md rename to collections/example/collection/roles/backup_file/README.md diff --git a/roles/backup_file/defaults/main.yml b/collections/example/collection/roles/backup_file/defaults/main.yml similarity index 100% rename from roles/backup_file/defaults/main.yml rename to collections/example/collection/roles/backup_file/defaults/main.yml diff --git a/roles/backup_file/handlers/main.yml b/collections/example/collection/roles/backup_file/handlers/main.yml similarity index 100% rename from roles/backup_file/handlers/main.yml rename to collections/example/collection/roles/backup_file/handlers/main.yml diff --git a/roles/backup_file/meta/main.yml b/collections/example/collection/roles/backup_file/meta/main.yml similarity index 100% rename from roles/backup_file/meta/main.yml rename to collections/example/collection/roles/backup_file/meta/main.yml diff --git a/roles/backup_file/molecule/default/INSTALL.rst b/collections/example/collection/roles/backup_file/molecule/default/INSTALL.rst similarity index 100% rename from roles/backup_file/molecule/default/INSTALL.rst rename to collections/example/collection/roles/backup_file/molecule/default/INSTALL.rst diff --git a/roles/backup_file/molecule/default/converge.yml b/collections/example/collection/roles/backup_file/molecule/default/converge.yml similarity index 100% rename from roles/backup_file/molecule/default/converge.yml rename to collections/example/collection/roles/backup_file/molecule/default/converge.yml diff --git a/roles/backup_file/molecule/default/create.yml b/collections/example/collection/roles/backup_file/molecule/default/create.yml similarity index 100% rename from roles/backup_file/molecule/default/create.yml rename to collections/example/collection/roles/backup_file/molecule/default/create.yml diff --git a/roles/backup_file/molecule/default/destroy.yml b/collections/example/collection/roles/backup_file/molecule/default/destroy.yml similarity index 100% rename from roles/backup_file/molecule/default/destroy.yml rename to collections/example/collection/roles/backup_file/molecule/default/destroy.yml diff --git a/roles/backup_file/molecule/default/molecule.yml b/collections/example/collection/roles/backup_file/molecule/default/molecule.yml similarity index 100% rename from roles/backup_file/molecule/default/molecule.yml rename to collections/example/collection/roles/backup_file/molecule/default/molecule.yml diff --git a/roles/backup_file/molecule/default/prepare.yml b/collections/example/collection/roles/backup_file/molecule/default/prepare.yml similarity index 100% rename from roles/backup_file/molecule/default/prepare.yml rename to collections/example/collection/roles/backup_file/molecule/default/prepare.yml diff --git a/roles/backup_file/molecule/default/templates/deployment.yml b/collections/example/collection/roles/backup_file/molecule/default/templates/deployment.yml similarity index 100% rename from roles/backup_file/molecule/default/templates/deployment.yml rename to collections/example/collection/roles/backup_file/molecule/default/templates/deployment.yml diff --git a/roles/backup_file/molecule/default/verify.yml b/collections/example/collection/roles/backup_file/molecule/default/verify.yml similarity index 100% rename from roles/backup_file/molecule/default/verify.yml rename to collections/example/collection/roles/backup_file/molecule/default/verify.yml diff --git a/roles/backup_file/requirements.yml b/collections/example/collection/roles/backup_file/requirements.yml similarity index 100% rename from roles/backup_file/requirements.yml rename to collections/example/collection/roles/backup_file/requirements.yml diff --git a/roles/backup_file/tasks/main.yml b/collections/example/collection/roles/backup_file/tasks/main.yml similarity index 100% rename from roles/backup_file/tasks/main.yml rename to collections/example/collection/roles/backup_file/tasks/main.yml diff --git a/roles/backup_file/tests/inventory b/collections/example/collection/roles/backup_file/tests/inventory similarity index 100% rename from roles/backup_file/tests/inventory rename to collections/example/collection/roles/backup_file/tests/inventory diff --git a/roles/backup_file/tests/test.yml b/collections/example/collection/roles/backup_file/tests/test.yml similarity index 100% rename from roles/backup_file/tests/test.yml rename to collections/example/collection/roles/backup_file/tests/test.yml diff --git a/roles/backup_file/vars/main.yml b/collections/example/collection/roles/backup_file/vars/main.yml similarity index 100% rename from roles/backup_file/vars/main.yml rename to collections/example/collection/roles/backup_file/vars/main.yml From 1642b332508cf8a307ececf8246f01fdb6a643b4 Mon Sep 17 00:00:00 2001 From: kyetter Date: Fri, 22 Sep 2023 14:34:05 -0400 Subject: [PATCH 5/6] documentation edits --- README.md | 18 +++++++++--------- collections/example/collection/README.md | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 0edc6e7..2adfdfa 100644 --- a/README.md +++ b/README.md @@ -3,9 +3,9 @@ To get started, simply click the button below... [![Contribute](https://www.eclipse.org/che/contribute.svg)](https://workspaces.openshift.com/f?url=https://github.com/devspaces-samples/ansible-devspaces-demo) -# Ansible Development on OpenShift DevSpaces +# Ansible Development on OpenShift Dev Spaces -This repository provides a development environment for Ansible playbook creation, testing with Molecule, and ansible-lint checks using OpenShift DevSpaces. +This repository provides a development environment for Ansible playbook creation, testing with Molecule, and ansible-lint checks using OpenShift Dev Spaces. ## Summary @@ -21,7 +21,7 @@ You can use the provided DevSpace to start working on your Ansible projects imme ## Setting up OpenShift DevSpaces -To get started with OpenShift DevSpaces, refer to the [OpenShift DevSpaces documentation](https://access.redhat.com/documentation/en-us/red_hat_openshift_dev_spaces/3.5/html/administration_guide/index) for detailed instructions on setting up your development environment and creating your DevSpaces. +To get started with OpenShift Dev Spaces, refer to the [OpenShift Dev Spaces documentation](https://access.redhat.com/documentation/en-us/red_hat_openshift_dev_spaces/3.5/html/administration_guide/index) for detailed instructions on setting up your development environment and creating your DevSpaces. ## Base Image Of Devfile @@ -33,7 +33,7 @@ The instructions for configuring OAuth2 for GitHub can be found at the following https://access.redhat.com/documentation/en-us/red_hat_openshift_dev_spaces/3.5/html/administration_guide/configuring-devspaces#configuring-oauth-2-for-github -Once the secret is in place, restart the main devspaces container. Any workspace created before this step is complete will NOT have access to GitHub OAuth, and will need to be deleted and recreated to get access. +Once the secret is in place, restart the main Dev Space container. Any workspace created before this step is complete will NOT have access to GitHub OAuth, and will need to be deleted and recreated to get access. NOTE: You will still need to configured your name/email globally the first time your workspace is accessed (or once for each new workspace, if you choose not to configure globally). @@ -44,7 +44,7 @@ git config --global user.email homer@springfieldpower.com ## Sample Molecule Testing Role -A sample role has been provided in the roles/backup_file directory to experiment with Test Driven Development using Molecule and OpenShift DevSpaces. A molecule verifier has been configured to test that the role functions as expected. +A sample role has been provided in the collections/example/collection/roles/backup_file directory to experiment with Test Driven Development using Molecule and OpenShift DevSpaces. A molecule verifier has been configured to test that the role functions as expected. ### Automation requirements 1. Make a backup of a file identified using the backup_file_source variable @@ -55,18 +55,18 @@ A sample role has been provided in the roles/backup_file directory to experiment ### To begin development against the backup_file role 1. Click the three horizontal bar icon in the top left of the window and select 'Terminal' -> 'New Terminal' 2. Click into the terminal window -3. Change directory into roles/backupfile `cd roles/backup_file` +3. Change directory into backup file role `cd collections/example/collection/roles/backup_file` 4. Run `molecule create`. This will start a test pod for the automation to run against (defined in roles/backup_file/molecule/default/molecule.yml). 5. Run `oc get pods` to view the test instance that was created 6. Run `molecule verify` to run the verification against the test pod and see the failures to help guide the tasks necessary in the role. -7. Run `molecule converge` to run the base tasks/main.yml against the pod. This will create a backup of a file in the backup destionation folder with a suffix appended. -8. Run `molecule converge` to execute the role against the test instance, and `molecule verify` to see if any tests are still failing. Repeate this until all tests pass. +7. Run `molecule converge` to run the base tasks/main.yml against the pod. This will create a backup of a file in the backup destination folder with a suffix appended. +8. Run `molecule converge` to execute the role against the test instance, and `molecule verify` to see if any tests are still failing. Repeat this until all tests pass. To reset your test pod back to a fresh instance you can run `molecule destroy` and then `molecule create` to recreate it. To run the full molecule test without stepping through each stage, run `molecule test`. ## Contributing -Contributions to this repository are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue or submit a pull request. You can ask any questions in the [Ansible-ZipShip-WG gchat channel](https://chat.google.com/room/AAAA8cZvmmw?cls=7) +Contributions to this repository are welcome! If you find any issues or have suggestions for improvements, feel free to open an issue with Red Hat. ## Code of Conduct We ask all of our community members and contributors to adhere to the [Ansible code of conduct](http://docs.ansible.com/ansible/latest/community/code_of_conduct.html). If you have questions or need assistance, please reach out to our community team at [codeofconduct@ansible.com](mailto:codeofconduct@ansible.com) diff --git a/collections/example/collection/README.md b/collections/example/collection/README.md index 7de42a2..354b2bd 100644 --- a/collections/example/collection/README.md +++ b/collections/example/collection/README.md @@ -1,3 +1,3 @@ # Ansible Collection - example.collection -Documentation for the collection. +An example collection to show off how to do Ansible collection and role development in Red Hat OpenShift Dev Spaces. From 1596c769b001f10193413cee72df9257133d4a11 Mon Sep 17 00:00:00 2001 From: Kathryn Yetter <46502874+kyetter@users.noreply.github.com> Date: Tue, 26 Sep 2023 15:40:28 -0400 Subject: [PATCH 6/6] Update devfile.yaml to correct path --- devfile.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/devfile.yaml b/devfile.yaml index fd38664..6ef37a3 100644 --- a/devfile.yaml +++ b/devfile.yaml @@ -23,7 +23,7 @@ commands: exec: label: "Molecule: Run Scenario for Backup Role" commandLine: 'source $HOME/.bashrc && molecule test' - workingDir: ${PROJECTS_ROOT}/ansible-devspaces-demo/roles/backup_file + workingDir: ${PROJECTS_ROOT}/ansible-devspaces-demo/collections/example/collection/roles/backup_file group: kind: run isDefault: true @@ -32,7 +32,7 @@ commands: exec: label: "Molecule: Validate Backup File Role" commandLine: 'source $HOME/.bashrc && molecule verify' - workingDir: ${PROJECTS_ROOT}/ansible-devspaces-demo/roles/backup_file + workingDir: ${PROJECTS_ROOT}/ansible-devspaces-demo/collections/example/collection/roles/backup_file group: kind: run isDefault: true