Remarques :

Ce tutoriel nécessite un accès à Oracle Cloud. Pour vous inscrire à un compte gratuit, reportez-vous à Introduction à Oracle Cloud Infrastructure Free Tier.
Il utilise des exemples de valeurs pour les informations d'identification, la location et les compartiments Oracle Cloud Infrastructure. Lorsque vous terminez votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

Provisionner un cluster de machines virtuelles Oracle Exadata Database Service on Cloud@Customer avec Ansible

Introduction

Ce tutoriel explique comment utiliser la collection OCI Ansible pour provisionner des clusters de machines virtuelles Oracle Exadata Database Service on Cloud@Customer. Pour créer un cluster de machines virtuelles Oracle Exadata Database Service on Cloud@Customer, vous devez d'abord créer le réseau de cluster de machines virtuelles correspondant.

Objectifs

Provisionnez un cluster de machines virtuelles et un réseau de cluster de machines virtuelles Oracle Exadata Database Service on Cloud@Customer à l'aide d'Ansible.

Prérequis

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 Oracle Cloud Infrastructure.

Pour plus d'informations, reportez-vous à Prérequis pour l'utilisation d'Ansible avec Oracle Cloud Infrastructure.

Tâche 1 : créer un stock

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 variables 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éation d'un Playbook pour provisionner un réseau de cluster de machines virtuelles

Créez un fichier de livre de jeux 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 de cluster de machines virtuelles nouvellement créé, y compris son OCID.

Remarque : 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 un cluster 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 jeux playbook_exacc_vmCluster_network_creation.yml, ajoutez la tâche suivante pour extraire l'OCID du réseau de cluster 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 jeux, playbook_exacc_vmCluster_network_creation.yml, ajoutez les tâches suivantes pour valider le réseau de cluster 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 jeux playbook_exacc_vmCluster_network_creation.yml, ajoutez les tâches suivantes pour afficher les détails du réseau de cluster 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écution de Playbook pour provisionner un réseau de cluster de machines virtuelles

Exécutez le guide de jeu de création de réseau de cluster de machines virtuelles avec l'option détaillée.
```
ansible-playbook playbook_exacc_vmCluster_network_creation.yml -i inventory_exacc.yml -vvv
```
Remarque : L'utilisation de l'option détaillée -vvv augmentera le niveau de détail et vous aidera à comprendre toutes les étapes sous-jacentes pendant l'exécution du manuel.

Au bout de quelques minutes, une exécution réussie du module oci_database_vm_cluster_network doit renvoyer 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éation d'un Playbook pour provisionner un cluster de machines virtuelles

Créez un fichier de livre de jeux 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 de cluster de machines virtuelles nouvellement créé, car il sera nécessaire pour la création du cluster de machines virtuelles.

Ajoutez la tâche de création de cluster de machines virtuelles dans le livre de jeux, 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

Les valeurs acceptées en cours 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].

Remarque : la création du cluster 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écution de Playbook pour provisionner un cluster de machines virtuelles

Exécutez le manuel de jeu de création de cluster de machines virtuelles avec l'option détaillée.
```
ansible-playbook playbook_exacc_vmCluster_creation.yml -i inventory_exacc.yml -vvv
```
Remarque : L'utilisation de l'option détaillée -vvv augmentera le niveau de détail et vous aidera à comprendre toutes les étapes sous-jacentes pendant l'exécution du manuel.

Au bout de quelques minutes, une exécution réussie du module oci_database_vm_cluster doit renvoyer 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éation d'un Playbook pour vérifier l'état du cluster de machines virtuelles nouvellement créé

Créez un fichier de livre de jeux 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écution de Playbook pour vérifier l'état du cluster de machines virtuelles nouvellement créé

Exécutez le manuel de vérification du cluster de machines virtuelles avec l'option détaillée.
```
ansible-playbook playbook_exacc_vmCluster_post_creation_checks.yml -i inventory_exacc.yml -vvv
```
Remarque : L'utilisation de l'option détaillée -vvv augmentera le niveau de détail et vous aidera à comprendre toutes les étapes sous-jacentes pendant l'exécution du manuel.
Au bout de quelques secondes, une exécution réussie du livre de jeux playbook_exacc_vmCluster_post_creation_checks.yml doit renvoyer 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 l'implémentation de la solution EMEA Cloud Lift - Base de données)

Ressources de formation supplémentaires

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

Pour obtenir la documentation produit, consultez le site Oracle Help Center.

Informations relatives au titre et au copyright

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

G27481-01

February 2025