Skip to content

Latest commit

 

History

History
205 lines (176 loc) · 6.65 KB

README.md

File metadata and controls

205 lines (176 loc) · 6.65 KB
Raw

Red Hat Satellite 6 Quick Start

This role will configure your Satellite server using the foreman-ansible-modules. It models the 10 Steps to Build an SOE: How Red Hat Satellite 6 Supports Setting up a Standard Operating Environment.

This role does the following:

  • Create your organization(s)
  • Adds a manfiest to the organization
  • Creates locations
  • Create a sync plans
  • Create content veiws
  • Enables Red Hat products
  • Create life cycle environments

Products and Content Views

  • vars/satellite_products.yml: This will define all the Red Hat products and repos.
  • vars/satellite_content_views.yml: This defines all the Content and Composite views.

Products

Currently supported products:

  • ansible
  • rhel8
  • rhel7
  • osp14
  • ceph3

Requirements

Requires:

Install the Foreman Ansible Modules collection on the control node

Currently using the collections via Copr.

sudo wget https://copr.fedorainfracloud.org/coprs/evgeni/foreman-ansible-modules/repo/epel-7/ -O /etc/yum.repos.d/evgeni-foreman-ansible-modules-epel-7.repo
sudo yum install -y ansible-collection-theforeman-foreman

Role Variables

Variable Required Default Description
rhsm_username ❌ null RHSM user name with priv to create manifest and attach subs on acces.redhat.com
rhsm_password ❌ null RHSM password
manifest_download_path ✔️ /root path on Satellite where manifest will be stored
rhsm_verify_ssl ❌ false "default is to use basic auth
satellite_orgs ✔️ see defaults/main.yml dictionary describing your satellite configuration details
local_manifest_path ✔️ null where on the controll node to find manifest to copy to Satellite
satellite_admin_user ✔️ null satellite admin user
satellite_user_pass ✔️ null satellite admin password
satellite_url ✔️ null satellite server url https://satellite.com
satellite_verify_ssl ❌ no "default is to use basic auth
force_manifest_upload ❌ false force the upload of a manifest to Satellite
foreman_ansible_module ❌ no set to yes to install the foreman-ansible-module on the ansible contoller
install_apypie ❌ no set to yes to install the python apypie module rpm on the Satellite server
check_requirements ❌ yes set to false to prevent checking if satellite server meeting the documented requirements

How To Use This Role

Products

This role is built around enabling the Red Hat products you have a subscription entitlement to. For each product or product group listed it will:

  • enable the product repository
  • create a content view or composite content
  • publish the content view to Library
  • create corresponding activation key
  • create a sync plan

Subscriptions

By default activation keys are created without any associated activation keys. You will need to edit defaults/activation_keys.yml with your subscription details for each activation key you want created.

For convenience, the variable default_subscription can be set instead of editing defaults/activation_keys.yml. This is useful if you have an subscription or a subscription that bundles lots of products like the one use in the example below.

Installation

ansible-galaxy install git+https://github.com/flyemsafe/satellite-day-two-ops.git

Example Playbook

Create your first ORG and upload a manifest

This example will create and download the manifest required for Satellite. You will need a subscription pool to continue with this example.

How to find your subscription pool:

  1. https://access.redhat.com/management/products
  2. Click on your product
  3. Select the subscriptions Tab next to Overview
  4. Select the subscription number
  hosts: sat01
  remote_user: root
  become: true
  gather_facts: true
  vars:
    satellite_admin_user: admin
    satellite_user_pass: password
    satellite_url: https://sat01.example.com
    satellite_verify_ssl: no
    rhsm_password: username
    rhsm_user: password
    manifest_download_path: /root
    local_manifest_path: ""
    default_subscription:
      - name: "Red Hat Cloud Suite (2-sockets), Premium"
    satellite_orgs:
      - name: CloudTeam
        state: present
        manifest: ""
        manifest_state: present
        manifest_force_upload: False
        sync_right_away: True
        use_local_manifest: False
        cdn_url: https://cdn.redhat.com
        wait_for_respo_sync: false
        pool:
          - id: 8a85f99b6977b7c0016979464ee772cb
            pool_state: present
            quantity: 7
        location:
          - name: Clearwater
            state: present
        products:
          - rhel7
          - rhel8
          - ansible
        lifecycle_environments:
          - name: Dev
            prior: Library
            state: present
            description: Dev environment
          - name: QA
            prior: Dev
            state: present
            description: QA environment
          - name: Production
            prior: QA
            state: present
            description: Production environment
        sync_plans:
          - name: "Red Hat Sync Plan"
            date: "2019/10/09 00:00:00 +0000"
            interval: daily
            enabled: true
            description: "Sync Plan for Red Hat products"
        domains:
          - name: example.com
            locations:
              - Clearwater
            organizations:
              - ACME
              - CloudTeam
            state: present
            description: example.com
        subnets:
          - name: lunchnet
            locations:
              - Clearwater
            organizations:
              - CloudTeam
            network: 192.24.24.0
            mask: 255.255.255.0
            gateway: 192.24.24.1
            from_ip: 192.24.24.200
            to_ip: 192.24.24.205
            domains:
              - example.com
            state: present
            description: 192.24.24.0
        compute_resource:
          - name: lunchnet
            locations:
              - Clearwater
            organizations:
              - CloudTeam
            state: present
            provider: libvirt
            provider_params:
              url: qemu+ssh://root@kvmhost/system
              display_type: vnc
            description: KVM Compute Host
  collections:
    - theforeman.foreman

  tasks:
  - name: TASK| runnning ansible-role-configure-katello
    include_role:
      name: satellite-day-two-ops
    tags: [always,manifest]