okd/roles/openshift_version/tasks/main.yml

---
# Determine the openshift_version to configure if none has been specified or set previously.

# Block attempts to install origin without specifying some kind of version information.
# This is because the latest tags for origin are usually alpha builds, which should not
# be used by default. Users must indicate what they want.
- name: Abort when we cannot safely guess what Origin image version the user wanted
  fail:
    msg: |-
      To install a containerized Origin release, you must set openshift_release or
      openshift_image_tag in your inventory to specify which version of the OpenShift
      component images to use. You may want the latest (usually alpha) releases or
      a more stable release. (Suggestion: add openshift_release="x.y" to inventory.)
  when:
  - openshift_is_containerized | bool
  - openshift.common.deployment_type == 'origin'
  - openshift_release is not defined
  - openshift_image_tag is not defined

# Normalize some values that we need in a certain format that might be confusing:
- set_fact:
    openshift_release: "{{ openshift_release[1:] }}"
  when:
  - openshift_release is defined
  - openshift_release[0] == 'v'

- set_fact:
    openshift_release: "{{ openshift_release | string }}"
  when:
  - openshift_release is defined

# Verify that the image tag is in a valid format
- when:
  - openshift_image_tag is defined
  - openshift_image_tag != "latest"
  block:

  # Verifies that when the deployment type is origin the version:
  # - starts with a v
  # - Has 3 integers seperated by dots
  # It also allows for optional trailing data which:
  # - must start with a dash
  # - may contain numbers, letters, dashes and dots.
  - name: (Origin) Verify openshift_image_tag is valid
    when: openshift.common.deployment_type == 'origin'
    assert:
      that:
      - "{{ openshift_image_tag is match('(^v?\\d+\\.\\d+\\.\\d+(-[\\w\\-\\.]*)?$)') }}"
      msg: |-
        openshift_image_tag must be in the format v#.#.#[-optional.#]. Examples: v1.2.3, v3.5.1-alpha.1
        You specified openshift_image_tag={{ openshift_image_tag }}

  # Verifies that when the deployment type is openshift-enterprise the version:
  # - starts with a v
  # - Has at least 2 integers seperated by dots
  # It also allows for optional trailing data which:
  # - must start with a dash
  # - may contain numbers
  # - may containe dots (https://github.com/openshift/openshift-ansible/issues/5192)
  #
  - name: (Enterprise) Verify openshift_image_tag is valid
    when: openshift.common.deployment_type == 'openshift-enterprise'
    assert:
      that:
      - "{{ openshift_image_tag is match('(^v\\d+\\.\\d+(\\.\\d+)*(-\\d+(\\.\\d+)*)?$)') }}"
      msg: |-
        openshift_image_tag must be in the format v#.#[.#[.#]]. Examples: v1.2, v3.4.1, v3.5.1.3,
        v3.5.1.3.4, v1.2-1, v1.2.3-4, v1.2.3-4.5, v1.2.3-4.5.6
        You specified openshift_image_tag={{ openshift_image_tag }}

# Make sure we copy this to a fact if given a var:
- set_fact:
    openshift_version: "{{ openshift_version | string }}"
  when: openshift_version is defined

# Protect the installed version by default unless explicitly told not to, or given an
# openshift_version already.
- name: Use openshift.common.version fact as version to configure if already installed
  set_fact:
    openshift_version: "{{ openshift.common.version }}"
  when:
  - openshift.common.version is defined
  - openshift_version is not defined or openshift_version == ""
  - openshift_protect_installed_version | bool

# The rest of these tasks should only execute on
# masters and nodes as we can verify they have subscriptions
- when:
  - inventory_hostname in groups['oo_masters_to_config'] or inventory_hostname in groups['oo_nodes_to_config']
  block:
  - name: Set openshift_version for rpm installation
    include_tasks: set_version_rpm.yml
    when: not openshift_is_containerized | bool

  - name: Set openshift_version for containerized installation
    include_tasks: set_version_containerized.yml
    when: openshift_is_containerized | bool

  - block:
    - name: Get available {{ openshift_service_type}} version
      repoquery:
        name: "{{ openshift_service_type}}"
        ignore_excluders: true
      register: rpm_results
    - fail:
        msg: "Package {{ openshift_service_type}} not found"
      when: not rpm_results.results.package_found
    - set_fact:
        openshift_rpm_version: "{{ rpm_results.results.versions.available_versions.0 | default('0.0', True) }}"
    - name: Fail if rpm version and docker image version are different
      fail:
        msg: "OCP rpm version {{ openshift_rpm_version }} is different from OCP image version {{ openshift_version }}"
      # Both versions have the same string representation
      when:
      - openshift_rpm_version != openshift_version
      # if openshift_pkg_version or openshift_image_tag is defined, user gives a permission the rpm and docker image versions can differ
      - openshift_pkg_version is not defined
      - openshift_image_tag is not defined
    when:
    - openshift_is_containerized | bool
    - not openshift_is_atomic | bool

  # Warn if the user has provided an openshift_image_tag but is not doing a containerized install
  # NOTE: This will need to be modified/removed for future container + rpm installations work.
  - name: Warn if openshift_image_tag is defined when not doing a containerized install
    debug:
      msg: >
        openshift_image_tag is used for containerized installs. If you are trying to
        specify an image for a non-container install see oreg_url or oreg_url_master or oreg_url_node.
    when:
    - not openshift_is_containerized | bool
    - openshift_image_tag is defined

  # At this point we know openshift_version is set appropriately. Now we set
  # openshift_image_tag and openshift_pkg_version, so all roles can always assume
  # each of this variables *will* be set correctly and can use them per their
  # intended purpose.

  - block:
    - debug:
        msg: "openshift_image_tag was not defined. Falling back to v{{ openshift_version }}"

    - set_fact:
        openshift_image_tag: v{{ openshift_version }}

    when: openshift_image_tag is not defined

  - block:
    - debug:
        msg: "openshift_pkg_version was not defined. Falling back to -{{ openshift_version }}"

    - set_fact:
        openshift_pkg_version: -{{ openshift_version }}

    when:
    - openshift_pkg_version is not defined
    - openshift_upgrade_target is not defined

  - fail:
      msg: openshift_version role was unable to set openshift_version
    name: Abort if openshift_version was not set
    when: openshift_version is not defined

  - fail:
      msg: openshift_version role was unable to set openshift_image_tag
    name: Abort if openshift_image_tag was not set
    when: openshift_image_tag is not defined

  - fail:
      msg: openshift_version role was unable to set openshift_pkg_version
    name: Abort if openshift_pkg_version was not set
    when:
    - openshift_pkg_version is not defined
    - openshift_upgrade_target is not defined


  - fail:
      msg: "No OpenShift version available; please ensure your systems are fully registered and have access to appropriate yum repositories."
    name: Abort if openshift_pkg_version was not set
    when:
    - not openshift_is_containerized | bool
    - openshift_version == '0.0'

  # We can't map an openshift_release to full rpm version like we can with containers; make sure
  # the rpm version we looked up matches the release requested and error out if not.
  - name: For an RPM install, abort when the release requested does not match the available version.
    when:
    - not openshift_is_containerized | bool
    - openshift_release is defined
    assert:
      that:
      - openshift_version.startswith(openshift_release) | bool
      msg: |-
        You requested openshift_release {{ openshift_release }}, which is not matched by
        the latest OpenShift RPM we detected as {{ openshift_service_type }}-{{ openshift_version }}
        on host {{ inventory_hostname }}.
        We will only install the latest RPMs, so please ensure you are getting the release
        you expect. You may need to adjust your Ansible inventory, modify the repositories
        available on the host, or run the appropriate OpenShift upgrade playbook.

  # The end result of these three variables is quite important so make sure they are displayed and logged:
  - debug: var=openshift_release

  - debug: var=openshift_image_tag

  - debug: var=openshift_pkg_version