Uploaded image for project: 'Red Hat Advanced Cluster Management'
  1. Red Hat Advanced Cluster Management
  2. ACM-16768

Segment on ansible inventory usage missing important details

XMLWordPrintable

    • False
    • None
    • False
    • Moderate
    • None

      Note: Doc team updates the current version of the documentation and the
      two previous versions (n-2), but we address *only high-priority, or
      customer-reported issues* for -2 releases in support.
      Describe the changes in the doc and link to your dev story:

      1. - [X] Mandatory: Add the required version to the Fix version/s field.

      2. - [X] Mandatory: Choose the type of documentation change or review.

      • [X] We need to update to an existing topic
      • [ ] We need to add a new document to an existing section
      • [ ] We need a whole new section; this is a function not
        documented before and doesn't belong in any current section
      • [ ] We need an Operator Advisory review and approval
      • [ ] We need a z-Stream (Errata) Advisory and Release note
        for MCE and/or ACM

      3. - [X] *Mandatory: *Use the following link to open the doc and find where the
      documentation update should go. Note: As the feature and doc is
      understood and developed, this placement decision may change:

      The segment that needs to be updated in the published documentations :

      In source this is https://github.com/stolostron/rhacm-docs/blob/2.13_stage/clusters/cluster_lifecycle/ansible_config_cluster.adoc#specifying-an-ansible-inventory-to-use-for-all-jobs

      4. - [ ] Mandatory for GA content:

      • [ ] Add steps, the diff, known issue, and/or other important
        conceptual information in the following space:
      • [ ] *Add Required access level *(example, *Cluster
        Administrator*) for the user to complete the task:
      • [ ] Add verification at the end of the task, how does the user
        verify success (a command to run or a result to see?)
      • [ ] Add link to dev story here:

      5. - [X] Mandatory for bugs: What is the diff? Clearly define what the
      problem is, what the change is, and link to the current documentation. Only
      use this for a documentation bug.

      The example used,

      apiVersion: cluster.open-cluster-management.io/v1beta1
      kind: ClusterCurator
      metadata: 
        name: test-inno
        namespace: test-inno
      spec: 
        desiredCuration: upgrade
        destroy: {}
        install: {}
        scale: {}
        upgrade: 
          channel: stable-4.x
          desiredUpdate: 4.x.1
          monitorTimeout: 150
          posthook: 
          - extra_vars: {}
            clusterName: test-inno
            type: post_check
            name: ACM Upgrade Checks
          prehook: 
          - extra_vars: {}
            clusterName: test-inno
            type: pre_check
            name: ACM Upgrade Checks
          towerAuthSecret: awx
      

      seems to be pre ansible 2.4 - since then it should be using `spec.inventory` :

      apiVersion: cluster.open-cluster-management.io/v1beta1
      kind: ClusterCurator
      metadata: 
        name: some-auto-temp
        namespace: default
        resourceVersion: "2070516"
      spec: 
        install: 
          towerAuthSecret: toweraccess
          prehook: ...
          posthook: ...
        upgrade: 
          towerAuthSecret: toweraccess
          prehook: ...
          posthook: ...
        inventory: Demo Inventory
      

      The current ansible supported versions are all way above 2.4 - a point that needs to be mentioned is that the inventory must already exist in ansible.

              rh-ee-ofischer Oliver Fischer
              rhn-support-fdewaley Felix Dewaleyne
              David Huynh David Huynh
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved: