homeroom_labs_deployer

Ansible Role: homeroom_labs_deployer =========

Ansible Role for deploying "Homeroom labs" on OpenShift.

NOTE: Despite the fact that this repository is named ansible-lab-deployer the role is named homeroom_labs_deployer.

Role Variables

Running an example

Install the role:

ansible-galaxy install openshift_labs.homeroom_labs_deployer

And now create your playbook (my-playbook.yml):

- name: Example Playbook
  hosts: localhost
  connection: local
  tasks:
  - import_role:
      name: homeroom_labs_deployer
    vars:
      lab_repo: "https://github.com/openshift-labs/lab-build-an-operator"
      lab_workshop_name: "Build an operator"
      lab_workshop_description: "Automate applications with k8s operators"

And execute it:

ansible-playbook my-playbook.yml

Use a requirements file

Create a requirements file (requirements.yml) to install the role:

- src: openshift_labs.homeroom_labs_deployer
  version: master
  name: homeroom_labs_deployer

Install the role:

ansible-galaxy install -r requirements.yml -f

Use meta/main.yaml

NOTE: this is kind of a hack to use this within a role

Add the dependency to your role including it in the dependencies section of your meta. This will execute that role with the provided vars.

dependencies:
  - role: openshift_labs.homeroom_labs_deployer
    version: master
    name: homeroom_labs_deployer
    vars:
      lab_repo: "https://github.com/openshift-labs/lab-build-an-operator"
      lab_workshop_description: "Automate applications with k8s operators"

More examples

Here are some other examples with alernate configuratiosn:

- name: Event specific configuration
  hosts: localhost
  connection: local
  tasks:
  - import_role:
      name: homeroom_labs_deployer
    vars:
      lab_repo: "https://github.com/openshift-labs/lab-build-an-operator"
      lab_branch: "rhte19"
      event: "rhte19"
      lab_workshop_description: "Automate applications with k8s operators"

OpenShift Version Compatibility

When listing this role, make sure to pin the version of the role via one of the tags:

- src: openshift_labs.homeroom_labs_deployer
  version: 1.0.0
  name: homeroom_labs_deployer

NOTE: This should be set in a requirements.yml file and installed via ansible-galaxy install -r requirements.yml -f

The following tables shows the version combinations that are tested and verified:

Note that if a version combination is not listed above, it does NOT mean that it won't work on that version. The above table is merely the combinations that we have verified and tested.