Note :

Ce tutoriel nécessite l'accès à Oracle Cloud. Pour vous inscrire à un compte gratuit, voir Démarrer avec le niveau gratuit d'Oracle Cloud Infrastructure.
Il utilise des exemples de valeurs pour les données d'identification, la location et les compartiments d'Oracle Cloud Infrastructure. À la fin de votre laboratoire, remplacez ces valeurs par celles qui sont propres à votre environnement en nuage.

Provisionner une grappe de machines virtuelles Oracle Exadata Database Service on Cloud@Customer avec Ansible

Présentation

Ce tutoriel explique comment utiliser la collection Ansible pour OCI pour provisionner des grappes de machine virtuelle Oracle Exadata Database Service on Cloud@Customer. Pour créer une grappe de machines virtuelles Oracle Exadata Database Service on Cloud@Customer, il est obligatoire de créer d'abord le réseau en grappe de machines virtuelles correspondant.

Objectifs

Provisionner un réseau en grappe de machines virtuelles et une grappe de machines virtuelles Oracle Exadata Database Service on Cloud@Customer à l'aide d'Ansible.

Préalables

Un compte Oracle Cloud Infrastructure (OCI) avec l'infrastructure Oracle Exadata Database Service on Cloud@Customer est disponible.
Une paire de clés SSH.
Un noeud de contrôle avec les composants suivants est déjà installé et configuré correctement.
- Ansible.
- Collection OCI Ansible.
- Interface de ligne de commande d'Oracle Cloud Infrastructure (interface de ligne de commande d'OCI).

Pour plus d'informations, voir Préalables à l'utilisation d'Ansible avec Oracle Cloud Infrastructure.

Tâche 1 : Créer un inventaire

Connectez-vous au noeud de contrôle Ansible correctement configuré.
Créez un fichier d'inventaire nommé inventory_exacc.yml avec le contenu suivant.
```
localhost ansible_connection=local
```

Tâche 2 : Créer un fichier de variables

Créez un fichier de variable nommé variables_exacc.yml avec toutes les variables décrites dans le contenu suivant.

# Your variables file

your_region: "eu-frankfurt-1"   # The OCI region where your resources will reside - This parameter is optional
your_exa_infra_id: "ocid1.exadatainfrastructure.oc1.eu-frankfurt-1.xxx"   # The OCI of your Exadata infrastructure

## Variables related to your VM cluster network

your_vm_net_comp_id: "ocid1.compartment.oc1..xxx"   # The compartment OCID of your VM cluster network
your_vm_net_name: "my_vm_cluster_network_name"   # The display name of your VM cluster network
your_vm_net_dns: "10.109.10.2"   # The list of your DNS server IP addresses. Maximum of 3 allowed.
your_vm_net_ntp: "10.109.10.3"   # The list of your NTP server IP addresses. Maximum of 3 allowed.
your_vm_net_scan_ips: ["203.101.10.123", "203.101.10.124", "203.101.10.125"]   # The list of your SCAN IP addresses. Three addresses should be provided.
your_vm_net_scan_listener_port_tcp: "1521"   # Your SCAN TCPIP port. Default is 1521.

### Variables related to your CLIENT network

your_cli_nodes_hostname_1: "your_1st_hostname"   # The hostname of your 1st node on the CLIENT network
your_cli_nodes_ip_1: "203.101.10.101"   # The IP address of your 1st node on the CLIENT network
your_cli_nodes_vip_hostname_1: "your_1st_hostname-vip"   # The node virtual IP (VIP) host name of your 1st node on the CLIENT network
your_cli_nodes_vip_1: "203.101.10.102"   # The node virtual IP (VIP) address of your 1st node on the CLIENT network
your_db_server_ocid_1: "ocid1.dbserver.oc1.eu-frankfurt-1.xxx"   # The Db server OCID associated with your 1st node on the CLIENT network

your_cli_nodes_hostname_2: "your_2nd_hostname"   # The hostname of your 2nd node on the CLIENT network
your_cli_nodes_ip_2: "203.101.10.103"   # The IP address of your 2nd node on the CLIENT network
your_cli_nodes_vip_hostname_2: "your_2nd_hostname-vip"   # The node virtual IP (VIP) host name of your 2nd node on the CLIENT network
your_cli_nodes_vip_2: "203.101.10.104"   # The node virtual IP (VIP) address of your 2nd node on the CLIENT network
your_db_server_ocid_2: "ocid1.dbserver.oc1.eu-frankfurt-1.yyy"   # The Db server OCID associated with your 2nd node on the CLIENT network

your_cli_vm_net_vlan_id: "123"   # Your CLIENT network VLAN ID
your_cli_vm_net_netmask: "your_client_netmask"   # Your CLIENT network netmask
your_cli_vm_net_gateway: "your_client_gateway_ip"   # Your CLIENT network gateway
your_cli_vm_net_domain_name: "your_client_network_domain_name"   # Your CLIENT network domain name

### Variables related to your BACKUP network

your_bck_nodes_hostname_1: "your_1st_hostname-bk"   # The hostname of your 1st node on the BACKUP network
your_bck_nodes_ip_1: "10.108.10.3"   # The IP address of your 1st node on the BACKUP network
your_bck_nodes_hostname_2: "your_2nd_hostname-bk"   # The hostname of your 2nd node on the BACKUP network
your_bck_nodes_ip_2: "10.108.10.4"   # The IP address of your 2nd node on the BACKUP network

your_bck_vm_net_vlan_id: "456"   # Your BACKUP network VLAN ID
your_bck_vm_net_netmask: "your_backup_netmask"   # Your BACKUP network netmask
your_bck_vm_net_gateway: "your_backup_gateway_ip"   # Your BACKUP network gateway
your_bck_vm_net_domain_name: "your_backup_network_domain_name"   # Your BACKUP network domain name

## Variables related to your VM cluster

your_vm_cluster_comp_id: "ocid1.compartment.oc1..yyy"   # The compartment OCID of your VM cluster
your_vm_cluster_name: "my_vm_cluster_name"
your_vm_clus_ssh_public_keys: [ "ssh-rsa AAAAB3NzaC...qScP4xMPQ9L5xWsqs" ]
your_license_model: "LICENSE_INCLUDED"   # The Oracle license model that applies to the VM cluster. The default is BRING_YOUR_OWN_LICENSE.

Tâche 3 : Créer un livre de jeu pour provisionner un réseau en grappe de machines virtuelles

Créez un fichier de livre de jeu nommé playbook_exacc_vmCluster_network_creation.yml avec le contenu suivant.

- hosts: localhost
  collections:
    - oracle.oci
  vars_files:
    - variables_exacc.yml
  tasks:
    - name: Create VM cluster network
      oci_database_vm_cluster_network:
        region: "{{ your_region }}"
        compartment_id: "{{ your_vm_net_comp_id }}"
        exadata_infrastructure_id: "{{ your_exa_infra_id }}"
        display_name: "{{ your_vm_net_name }}"
        dns: "{{ your_vm_net_dns }}"
        ntp: "{{ your_vm_net_ntp }}"
        scans:
        - hostname: "{{ your_vm_clus_name }}-scan"
          ips: "{{ your_vm_net_scan_ips }}"
          scan_listener_port_tcp: "{{ your_vm_net_scan_listener_port_tcp }}"
        vm_networks:
        - network_type: CLIENT
          nodes:
          - hostname: "{{ your_cli_nodes_hostname_1 }}"
            ip: "{{ your_cli_nodes_ip_1 }}"
            vip_hostname: "{{ your_cli_nodes_vip_hostname_1 }}"
            vip: "{{ your_cli_nodes_vip_1 }}"
            db_server_id: "{{ your_db_server_ocid_1 }}"
          - hostname: "{{ your_cli_nodes_hostname_2 }}"
            ip: "{{ your_cli_nodes_ip_2 }}"
            vip_hostname: "{{ your_cli_nodes_vip_hostname_2 }}"
            vip: "{{ your_cli_nodes_vip_2 }}"
            db_server_id: "{{ your_db_server_ocid_2 }}"
          vlan_id: "{{ your_cli_vm_net_vlan_id }}"
          netmask: "{{ your_cli_vm_net_netmask }}"
          gateway: "{{ your_cli_vm_net_gateway }}"
          domain_name: "{{ your_cli_vm_net_domain_name }}"
        - network_type: BACKUP
          nodes:
          - hostname: "{{ your_bck_nodes_hostname_1 }}"
            ip: "{{ your_bck_nodes_ip_1 }}"
            vip_hostname: "{{ your_bck_nodes_vip_hostname_1 }}"
            vip: "{{ your_bck_nodes_vip_1 }}"
            db_server_id: "{{ your_db_server_ocid_1 }}"
          - hostname: "{{ your_bck_nodes_hostname_2 }}"
            ip: "{{ your_bck_nodes_ip_2 }}"
            vip_hostname: "{{ your_bck_nodes_vip_hostname_2 }}"
            vip: "{{ your_bck_nodes_vip_2 }}"
            db_server_id: "{{ your_db_server_ocid_2 }}"
          vlan_id: "{{ your_bck_vm_net_vlan_id }}"
          netmask: "{{ your_bck_vm_net_netmask }}"
          gateway: "{{ your_bck_vm_net_gateway }}"
          domain_name: "{{ your_bck_vm_net_domain_name }}"
        wait: true
      register: new_vmClusterNetwork

Notez le mot clé de tâche register, à la fin de l'appel du module oci_database_vm_cluster_network : cela signifie que la sortie du module sera enregistrée dans la variable new_vmClusterNetwork. Cette variable contiendra tous les détails du réseau en grappe de machines virtuelles nouvellement créé, y compris son OCID.

Note : Pour ce tutoriel, il n'y a que deux dictionnaires de noeuds pour chaque type de réseau, car l'infrastructure Exadata sous-jacente contient deux db servers. Pour créer une grappe de machines virtuelles avec quatre ou huit noeuds, il est nécessaire de fournir le nombre adéquat de dictionnaires de noeuds pour chaque type de réseau.

Dans le livre de jeu playbook_exacc_vmCluster_network_creation.yml, ajoutez la tâche suivante pour extraire l'OCID du réseau en grappe de machines virtuelles nouvellement créé.

- name: Get OCID of newly created VM cluster network
  set_fact:
    your_vm_net_ocid: "{{ item.id }}"
  loop:
  - "{{ new_vmClusterNetwork.vm_cluster_network }}"
  loop_control:
    label: "{{ item.display_name }}"

Dans le livre de jeu, playbook_exacc_vmCluster_network_creation.yml, ajoutez les tâches suivantes pour valider le réseau en grappe de machines virtuelles nouvellement créé et télécharger sa configuration.

    - name: Validate VM cluster network
      oci_database_vm_cluster_network_actions:
        exadata_infrastructure_id: "{{ your_exa_infra_id }}"
        vm_cluster_network_id: "{{ your_vm_net_ocid }}"
        region: "{{ your_region }}"
        action: validate


    - name: Download network configuration file of VM cluster network
      oci_database_vm_cluster_network_actions:
        exadata_infrastructure_id: "{{ your_exa_infra_id }}"
        vm_cluster_network_id: "{{ your_vm_net_ocid }}"
        action: download_vm_cluster_network_config_file
        config_file_dest: "/tmp/net_config_my_vm_cluster_network.json"
        region: "{{ your_region }}"

Dans le livre de jeu playbook_exacc_vmCluster_network_creation.yml, ajoutez les tâches suivantes pour afficher les détails du réseau en grappe de machines virtuelles nouvellement créé après sa validation.

    - name: Get facts of newly created VM cluster network
      oci_database_vm_cluster_network_facts:
        exadata_infrastructure_id: "{{ your_exa_infra_id }}"
        vm_cluster_network_id: "{{ your_vm_net_ocid }}"
        region: "{{ your_region }}"
      register: newly_created_VM_cluster_network_facts


    - name: Display details of newly created VM cluster network
      debug:
        msg : "{{ newly_created_VM_cluster_network_facts.vm_cluster_networks }}"

Tâche 4 : Exécuter le livre de jeu pour provisionner un réseau en grappe de machines virtuelles

Exécutez le livre de jeu de création de réseau en grappe de machines virtuelles avec l'option verbose.
```
ansible-playbook playbook_exacc_vmCluster_network_creation.yml -i inventory_exacc.yml -vvv
```
Note : L'utilisation de l'option verbose -vvv augmentera la verbosité et vous aidera à comprendre toutes les étapes sous-jacentes pendant l'exécution du livre de jeu.

Après quelques minutes, une exécution réussie du module oci_database_vm_cluster_network doit retourner la sortie suivante.

changed: [localhost] => {
[...],
    "vm_cluster_network": {
        "compartment_id": "ocid1.compartment.oc1..xxx",
        "defined_tags": {
            "Oracle-Tags": {
                "CreatedBy": "creation_user",
                "CreatedOn": "2025-01-09T09:30:30.631Z"
            }
        },
        "display_name": "my_vm_cluster_network_name",
        "dns": [
            "10.109.10.2"
        ],
        "dr_scans": null,
        "exadata_infrastructure_id": "ocid1.exadatainfrastructure.oc1.eu-frankfurt-1.xxx",
        "freeform_tags": {},
        "id": "ocid1.vmclusternetwork.oc1.eu-frankfurt-1.xxx",
        "lifecycle_details": null,
        "lifecycle_state": "REQUIRES_VALIDATION",
        "ntp": [
            "10.109.10.3"
        ],
        "scans": [
            {
                "hostname": "name_of_your-scan",
                "ips": [
                    "203.101.10.123",
                    "203.101.10.124",
                    "203.101.10.125"
                ],
                "port": 1521,
                "scan_listener_port_tcp": 1521,
                "scan_listener_port_tcp_ssl": 2484
            }
        ],
        "time_created": "2025-01-09T09:30:30.818000+00:00",
        "vm_cluster_id": null,
        "vm_networks": [
            {
                "domain_name": "your_client_network_domain_name",
                "gateway": "your_client_gateway_ip",
                "netmask": "your_client_netmask",
                "network_type": "CLIENT",
                "nodes": [
                    {
                        "db_server_id": "ocid_of_your_1st_db_server",
                        "hostname": "your_1st_hostname",
                        "ip": "203.101.10.101",
                        "lifecycle_state": "REQUIRES_VALIDATION",
                        "vip": "203.101.10.102",
                        "vip_hostname": "your_1st_hostname-vip"
                    },
                    {
                        "db_server_id": "ocid_of_your_2nd_db_server",
                        "hostname": "your_2nd_hostname",
                        "ip": "203.101.10.103",
                        "lifecycle_state": "REQUIRES_VALIDATION",
                        "vip": "203.101.10.104",
                        "vip_hostname": "your_2nd_hostname-vip"
                    }
                ],
                "vlan_id": "123"
            },
            {
                "domain_name": "your_backup_network_domain_name",
                "gateway": "your_backup_gateway_ip",
                "netmask": "your_backup_netmask",
                "network_type": "BACKUP",
                "nodes": [
                    {
                        "db_server_id": "ocid_of_your_1st_db_server",
                        "hostname": "your_1st_hostname-bk",
                        "ip": "10.108.10.3",
                        "lifecycle_state": "REQUIRES_VALIDATION",
                    },
                    {
                        "db_server_id": "ocid_of_your_2nd_db_server",
                        "hostname": "your_2nd_hostname-bk",
                        "ip": "10.108.10.4",
                        "lifecycle_state": "REQUIRES_VALIDATION",
                    }
                ],
                "vlan_id": "456"
            }
        ]
    }
}

Tâche 5 : Créer un livre de jeu pour provisionner une grappe de machines virtuelles

Créez un fichier de livre de jeu nommé playbook_exacc_vmCluster_creation.yml avec le contenu suivant.

- hosts: localhost
  collections:
    - oracle.oci
  vars_files:
    - variables_exacc.yml
  tasks:

    - name: Get all existing VM cluster networks
      oci_database_vm_cluster_network_facts:
        exadata_infrastructure_id: "{{ your_exa_infra_id }}"
        compartment_id: "{{ your_vm_net_comp_id }}"
        region: "{{ your_region }}"
      register: get_all_vmClusterNetworks


    - name: Get OCID of the newly created VM cluster network
      set_fact:
        your_vm_net_ocid: "{{ item.id }}"
      loop: "{{ get_all_vmClusterNetworks.vm_cluster_networks }}"
      loop_control:
        label: "{{ item.display_name }}"
      when: item.display_name == your_vm_net_name

Ces 2 tâches sont utilisées pour extraire l'OCID du réseau en grappe de machines virtuelles nouvellement créé, car il sera nécessaire pour la création de la grappe de machines virtuelles.

Ajoutez la tâche de création de grappe de machines virtuelles dans le livre de jeu, playbook_exacc_vmCluster_creation.yml.

- name: Create VM cluster
  oci_database_vm_cluster:
    region: "{{ your_region }}"
    compartment_id: "{{ your_vm_cluster_comp_id }}"
    display_name: "{{ your_vm_cluster_name }}"
    exadata_infrastructure_id: "{{ your_exa_infra_id }}"
    vm_cluster_network_id: "{{ your_vm_net_ocid }}"
    gi_version: "19.0.0.0.0"
    cpu_core_count: "4"
    ssh_public_keys: "{{ your_vm_clus_ssh_public_keys }}"
    time_zone: "Europe/Zurich"
    memory_size_in_gbs: "60"
    db_node_storage_size_in_gbs: "120"
    data_storage_size_in_tbs: "2"
    license_model: "{{ your_license_model }}"
    is_sparse_diskgroup_enabled: "false"
    is_local_backup_enabled: "false"
    data_collection_options:
      is_diagnostics_events_enabled: "false"
      is_health_monitoring_enabled: "false"
      is_incident_logs_enabled: "false"
    wait: true
    wait_timeout: 18000

Notez que les valeurs acceptées courantes pour le paramètre gi_version sont 19.0.0.0.0 et 23.0.0.0.0. Sinon, vous obtiendrez l'erreur suivante : Cannot create VM cluster because Oracle Grid Infrastructure version is invalid. Valid versions are: [19.0.0.0.0, 23.0.0.0.0].

Note : La création de la grappe de machines virtuelles prend généralement jusqu'à 3 heures. C'est pourquoi les instructions wait: true et wait_timeout: 18000 sont ajoutées dans le code.

Tâche 6 : Exécuter le livre de jeu pour provisionner une grappe de machines virtuelles

Exécutez le livre de jeu de création de grappe de machines virtuelles avec l'option verbose.
```
ansible-playbook playbook_exacc_vmCluster_creation.yml -i inventory_exacc.yml -vvv
```
Note : L'utilisation de l'option verbose -vvv augmentera la verbosité et vous aidera à comprendre toutes les étapes sous-jacentes pendant l'exécution du livre de jeu.

Après quelques minutes, une exécution réussie du module oci_database_vm_cluster doit retourner la sortie suivante.

changed: [localhost] => {
[...],
    "vm_clusters": [
        {
            "availability_domain": "your_availability_domain",
            "compartment_id": "ocid1.compartment.oc1..yyy",
            "cpus_enabled": 4,
            "data_collection_options": {
                "is_diagnostics_events_enabled": false,
                "is_health_monitoring_enabled": false,
                "is_incident_logs_enabled": false
            },
            "data_storage_size_in_gbs": null,
            "data_storage_size_in_tbs": 2.0,
            "db_node_storage_size_in_gbs": 120,
            "db_servers": [
                "ocid1.dbserver.oc1.eu-frankfurt-1.xxx",
                "ocid1.dbserver.oc1.eu-frankfurt-1.yyy"
            ],
            "defined_tags": {
                "Oracle-Tags": {
                    "CreatedBy": "creation_user",
                    "CreatedOn": "2025-01-09T12:40:17.201Z"
                }
            },
            "display_name": "my_vm_cluster_name",
            "exadata_infrastructure_id": "ocid1.exadatainfrastructure.oc1.eu-frankfurt-1.xxx",
            "file_system_configuration_details": [
                {
                    "file_system_size_gb": 15,
                    "mount_point": "/"
                },
                [...],
                {
                    "file_system_size_gb": 16,
                    "mount_point": "swap"
                }
            ],
            "freeform_tags": {},
            "gi_software_image_id": null,
            "gi_version": "19.24.0.0.0",
            "id": "ocid1.vmcluster.oc1.eu-frankfurt-1.xxx",
            "is_local_backup_enabled": false,
            "is_sparse_diskgroup_enabled": false,
            "last_patch_history_entry_id": null,
            "license_model": "your_license_model",
            "lifecycle_details": null,
            "lifecycle_state": "AVAILABLE",
            "memory_size_in_gbs": 60,
            "ocpus_enabled": null,
            "shape": "your_ExadataCC_shape",
            "ssh_public_keys": null,
            "system_version": "24.1.6.0.0.241115",
            "time_created": "2025-01-09T12:40:17.256000+00:00",
            "time_zone": "Europe/Zurich",
            "vm_cluster_network_id": "your_newly_created_vmCluster_network_OCID"
        }
    ]
}

Tâche 7 : Créer un livre de jeu pour vérifier l'état de la grappe de machines virtuelles nouvellement créée

Créez un fichier de livre de jeu nommé playbook_exacc_vmCluster_post_creation_checks.yml avec le contenu suivant.

- hosts: localhost
  collections:
    - oracle.oci
  vars_files:
    - variables_exacc.yml
  tasks:
    - name: Get newly created vmCluster facts
      oci_database_vm_cluster_facts:
        region: "{{ your_region }}"
        compartment_id: "{{ your_vm_cluster_comp_id }}"
        exadata_infrastructure_id: "{{ your_exa_infra_id }}"
        display_name: "{{ your_vm_cluster_name }}"
      register: output_cluster_facts


    - name: Set vmCluster facts
      set_fact:
        your_vm_cluster_id: "{{ item.id }}"
        your_vm_cluster_state: "{{ item.lifecycle_state }}"
      loop: "{{ output_cluster_facts.vm_clusters }}"
      loop_control:
        label: "{{ item.display_name }}"
      when: item.display_name == your_vm_cluster_name


    - name: Check VM cluster state
      debug:
        msg: "The VM cluster  your_vm_cluster_name  is in lifecycle state  your_vm_cluster_state ."

Tâche 8 : Exécuter le livre de jeu pour vérifier l'état de la grappe de machines virtuelles nouvellement créée

Exécutez le livre de jeu de vérification de grappe de machines virtuelles avec l'option verbose.
```
ansible-playbook playbook_exacc_vmCluster_post_creation_checks.yml -i inventory_exacc.yml -vvv
```
Note : L'utilisation de l'option verbose -vvv augmentera la verbosité et vous aidera à comprendre toutes les étapes sous-jacentes pendant l'exécution du livre de jeu.
Après quelques secondes, une exécution réussie du livre de jeu playbook_exacc_vmCluster_post_creation_checks.yml doit retourner la sortie suivante.
```
ok: [localhost] => {
    "msg": "The VM cluster your_vm_cluster_name is in lifecycle state AVAILABLE."
}
```

Remerciements

Auteurs - Flora Barriele (Directeur technique de mise en oeuvre de Cloud Lift pour la région EMEA - Base de données)

Autres ressources d'apprentissage

Explorez d'autres laboratoires sur le site docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation sur le produit, visitez Oracle Help Center.

Informations sur le titre et les droits d'auteur

Provision an Oracle Exadata Database Service on Cloud@Customer Virtual Machine Cluster with Ansible

G27480-01

February 2025