diff --git a/README.md b/README.md index 78a1a7e..2adfdfa 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,11 @@ +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 -This repository provides a development environment for Ansible playbook creation, testing with Molecule, and ansible-lint checks using 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 Dev Spaces. ## Summary @@ -18,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 @@ -30,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). @@ -41,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 @@ -52,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 new file mode 100644 index 0000000..354b2bd --- /dev/null +++ b/collections/example/collection/README.md @@ -0,0 +1,3 @@ +# Ansible Collection - example.collection + +An example collection to show off how to do Ansible collection and role development in Red Hat OpenShift Dev Spaces. 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 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