vmware builds

roles/oatakan.rhel_ovirt_template/README.md

@@ -0,0 +1,86 @@
+# rhel_ovirt_template
+This repo contains an Ansible role that builds a RHEL/CentOS VM template from an ISO file on Ovirt/RHV.
+You can run this role as a part of CI/CD pipeline for building RHEL/CentOS templates on Ovirt/RHV from an ISO file.
+
+> **_Note:_** This role is provided as an example only. Do not use this in production. You can fork/clone and add/remove steps for your environment based on your organization's security and operational requirements.
+
+Requirements
+------------
+
+You need to have the following packages installed on your control machine:
+
+- mkisofs
+- genisoimage
+
+You need to enable qemu_cmdline hook on your RHV/Ovirt environment, this is required to enable attaching multiple iso files. Follow the instructions documented here:
+
+https://www.ovirt.org/develop/developer-guide/vdsm/hook/qemucmdline.html
+
+Before you can use this role, you need to make sure you have RHEL/CentOS install media iso file uploaded to a iso domain on your RHV/Ovirt environment.
+
+Role Variables
+--------------
+
+A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.
+
+Dependencies
+------------
+
+Import ovirt.ovirt collections.
+
+A list of roles that this role utilizes:
+
+- oatakan.rhn
+- oatakan.rhel_upgrade
+- oatakan.rhel_template_build
+
+Example Playbook
+----------------
+
+Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
+
+    # import ovirt.ovirt collections
+    - name: create a ovirt rhel template
+      hosts: all
+      gather_facts: False
+      connection: local
+      become: no
+      vars:
+        template_force: yes #overwrite existing template with the same name
+        export_ovf: no # export the template to export domain upon creation
+        local_account_password: ''
+        local_administrator_password: ''
+        linux_distro_name: rhel_81 # this needs to be one of the standard values see 'os_short_names' var
+        template_vm_name: rhel81-x64-v1
+        template_vm_root_disk_size: 10
+        template_vm_memory: 4096
+        template_vm_efi: false # you need to install efi file to use this, false should be fine in most cases
+        iso_file_name: '' # name of the iso file
+        
+        ovirt_datacenter: '' # name of the datacenter
+        ovirt_cluster: '' # name of the cluster
+        ovirt_data_domain: '' # name of the data domain
+        ovirt_export_domain: '' # name of the iso domain
+        ovirt_iso_domain: '' # this is deprecated as of 4.3 you can omit if not used
+        
+        template_vm_network_name: ovirtmgmt
+        template_vm_ip_address: 192.168.10.95 # static ip is required
+        template_vm_netmask: 255.255.255.0
+        template_vm_gateway: 192.168.10.254
+        template_vm_domain: example.com
+        template_vm_dns_servers:
+        - 8.8.4.4
+        - 8.8.8.8
+    
+      roles:
+        - oatakan.rhel_ovirt_template
+
+License
+-------
+
+MIT
+
+Author Information
+------------------
+
+Orcun Atakan