Nota

Usa OCI Ansible Collection con Oracle Linux Automation Manager

Introduzione

Oracle Cloud Infrastructure (OCI) Ansible Collection offre un modo semplice per eseguire il provisioning e gestire le risorse in Oracle Cloud utilizzando Oracle Linux Automation Engine o Oracle Linux Automation Manager.

Obiettivi

In questo tutorial imparerai come:

Prerequisiti

Distribuisci Oracle Linux Automation Manager

Nota: se è in esecuzione nella propria tenancy, leggere il progetto linux-virt-labs GitHub README.md e completare i prerequisiti prima di distribuire l'ambiente di esercitazione pratica.

  1. Aprire un terminale sul Luna Desktop.

  2. Duplica il progetto linux-virt-labs GitHub.

    git clone https://github.com/oracle-devrel/linux-virt-labs.git

  3. Passare alla directory di lavoro.

    cd linux-virt-labs/olam

  4. Installare le raccolte richieste.

    ansible-galaxy collection install -r requirements.yml

  5. Aggiornare la configurazione dell'istanza Oracle Linux.

    cat << EOF | tee instances.yml > /dev/null
compute_instances:
  1:
    instance_name: "olam-node"
    type: "control"
  2:
    instance_name: "git-server"
    type: "server"
use_git: true
olam_type: single
EOF

  6. Creare un file di inventario.

    cat << EOF | tee hosts > /dev/null
localhost ansible_connection=local ansible_connection=local ansible_python_interpreter=/usr/bin/python3.6
EOF

  7. Implementa l'ambiente di laboratorio.

    ansible-playbook create_instance.yml -i hosts -e "@instances.yml"

    L'ambiente di laboratorio gratuito richiede la variabile extra ansible_python_interpreter per localhost perché installa il pacchetto RPM per Oracle Cloud Infrastructure SDK per Python. La posizione per l'installazione di questo pacchetto si trova sotto i moduli Python predefiniti del sistema in base alla versione di Oracle Linux in uso. L'utilizzo di una variabile di inventario evita di influire sulle riproduzioni in esecuzione su host diversi da localhost.

    La forma di distribuzione predefinita utilizza la CPU AMD. È possibile modificare la forma delle istanze passando una nuova definizione di variabile forma sulla riga di comando.

    Ad esempio: -e instance_shape="VM.Standard3.Flex"

    Analogamente, la versione predefinita dell'immagine Oracle Linux utilizza la variabile os_version definita nel file `default_vars.yml. È possibile modificare questo valore passando la versione principale di Oracle Linux dalla riga di comando.

    Ad esempio: -e os_version="9"

    Importante: attendere che il playbook venga eseguito correttamente e raggiungere il task di sospensione. In questa fase del playbook, l'installazione di Oracle Linux è completa e le istanze sono pronte. Nota la riproduzione precedente, che stampa gli indirizzi IP pubblici e privati dei nodi che distribuisce.

Crea un Playbook

  1. Aprire una nuova finestra del terminale.

  2. Impostare una variabile sull'istanza remota di git-server.

    export REMOTE=<ip_address_of_instance>

  3. Creare una directory di progetto.

    mkdir ~/myproject

  4. Creare un file dei requisiti.

    Oracle Linux Automation Engine utilizza il file dei requisiti per inserire nel progetto le raccolte o i ruoli necessari in fase di esecuzione.

    cat << EOF > ~/myproject/requirements.yml 
---
collections:
  - name: oracle.oci
  - name: community.general
EOF

    Nota: per le versioni di Oracle Linux Automation Engine < 2.13.9, è possibile configurare il file dei requisiti per estrarre la raccolta direttamente dal repository GitHub delle raccolte.

    cat << EOF > ~/myproject/requirements.yml 
---
collections:
  - name: https://github.com/oracle/oci-ansible-collection.git
    type: git
    version: master
  - name: https://github.com/ansible-collections/community.general.git
    type: git
    version: main
EOF

  5. Crea una guida.

    Questo playbook esegue una query sullo spazio di nomi dello storage degli oggetti per la tenancy Oracle Cloud Infrastructure. I dettagli della tenancy verranno configurati in un secondo momento nell'interfaccia utente Web di Oracle Linux Automation Manager.

    cat << EOF > ~/myproject/get_namespace.yml
---
- name: Get namespace name
  hosts: localhost

  tasks:

  - name: get namespace
    oracle.oci.oci_object_storage_namespace_facts:
    register: output

  - name: print namespace
    ansible.builtin.debug:
      msg: ""
EOF

Aggiunta del progetto al controllo versione

  1. Inizializzare la directory di lavoro del progetto in un repository Git.

    Prima di inizializzare il repository, è necessario eseguire alcuni passi di configurazione della prima volta di Git.

    1. Impostare il nome diramazione predefinito utilizzato durante l'inizializzazione di un progetto.

      git config --global init.defaultBranch main

    2. Imposta la tua identità.

      L'e-mail e il nome sono esempi in questa esercitazione. Utilizza il tuo indirizzo e-mail e il tuo nome quando lavori sui tuoi progetti, poiché git include immutabilmente queste informazioni in ogni commit.

      git config --global user.email johndoe@example.com
git config --global user.name "John Doe"

    3. Passare alla directory di lavoro del progetto.

      cd ~/myproject

    4. Inizializzare la directory come repository Git locale.

      git init

      Il comando restituisce che ha inizializzato il repository Git vuoto.

  2. Controllare lo stato della directory di lavoro e dell'area intermedia del progetto.

    git status

    Lo stato del repository locale indica due file non controllati: get_namespace.yml e requirements.yml

  3. Aggiungere e tenere traccia dei nuovi file nell'area intermedia.

    git add --all

    L'opzione --all consente di aggiungere all'area intermedia tutti i file non tracciati e modificati.

  4. Eseguire il commit delle modifiche attualmente nell'area intermedia.

    git commit -m 'initial commit'

    L'opzione -m consente di aggiungere un commento alle modifiche di cui è stato eseguito il commit.

  5. Creare e inizializzare il repository Git remoto.

    Un repository remoto è un repository condiviso utilizzato da tutti i collaboratori del progetto e memorizzato in un servizio di code-hosting, ad esempio GitHub o un server self-hosted.

    ssh git@$REMOTE "git init -b main --bare /git-server/repos/myproject.git"

    L'opzione -b garantisce l'inizializzazione del repository remoto utilizzando una diramazione denominata main.

  6. Accettare l'impronta digitale del tasto ECDSA digitando yes.

  7. Aggiungere il nuovo record di connessione al repository remoto.

    L'aggiunta della connessione remota al repository locale consente di utilizzarla come collegamento denominato nei comandi Git.

    git remote add origin git@$REMOTE:/git-server/repos/myproject.git

    Il percorso dopo i due punti è la posizione della directory del repository sul server Git remoto.

  8. Verificare il record di connessione appena aggiunto.

    git remote -v

    L'output mostra il record di connessione origin che punta alla posizione del repository Git remoto sia per i comandi git fetch che per i comandi git push.

  9. Esegue il push delle modifiche del repository locale nel repository remoto.

    git push origin main

    È ora possibile utilizzare l'origine myproject all'interno di un progetto Oracle Linux Automation Manager.

Crea credenziali Galaxy Ansible

Queste credenziali consentono a Oracle Linux Automation Manager di estrarre la raccolta Ansible OCI dall'hub Galaxy Ansible pubblico.

  1. Aprire una nuova finestra del terminale e configurare un tunnel SSH per l'istanza olam-node.

    ssh -L 8444:localhost:443 oracle@<ip_address_of_instance>

  2. Aprire un browser Web e immettere l'URL.

    https://localhost:8444

    Nota: approvare l'avvertenza di sicurezza in base al browser utilizzato. Per il browser Chrome, fare clic sul pulsante Avanzate, quindi sul collegamento Procedi a localhost (non sicuro).

  3. Eseguire il login all'interfaccia utente Web di Oracle Linux Automation Manager. Utilizzare il nome utente admin e la password admin creati durante la distribuzione automatica.

    olam2: login

  4. L'interfaccia utente Web viene visualizzata dopo un login riuscito.

    olam2-webui

  5. Fare clic su Credenziali nella sezione Risorse del menu di navigazione.

  6. Fare clic sul pulsante Aggiungi.

  7. Immettere o selezionare i seguenti valori nei campi specifici.

    Per i campi con una ricerca o un elenco di valori, è possibile iniziare a digitare il valore richiesto e quindi selezionarlo dall'elenco.

    • Nome: My Ansible Galaxy
    • Organizzazione: Default
    • Tipo di credenziale: token API Ansible Galaxy/Automation Hub

    Oracle Linux Automation Manager utilizza le credenziali di Ansible Galaxy per facilitare il download di ruoli e raccolte utilizzando il comando ansible-galaxy.

    • URL di Galaxy Server: https://galaxy.ansible.com

    olam2-ansible-galaxy-creds

  8. Rivedere le voci e fare clic sul pulsante Salva.

  9. Fare clic su Organizzazioni nella sezione Accesso del menu di navigazione.

    L'assegnazione della credenziale Ansible Galaxy all'interno dell'organizzazione consente di scaricare la raccolta Ansible dell'infrastruttura Oracle Linux dall'interno del progetto git.

  10. Fare clic sull'organizzazione Predefinita e fare clic sul pulsante Modifica.

  11. Selezionare la credenziale Il mio Galaxy Ansible nel campo Credenziali galassie e fare clic sul pulsante Seleziona.

  12. Rivedere e fare clic sul pulsante Salva.

    olam2-ansible-galaxy-org

Crea credenziali OCI

Le credenziali OCI forniscono informazioni su Oracle Linux Automation Manager sulla tenancy OCI specifica.

  1. Fare clic su Credenziali nel menu di navigazione.

  2. Fare clic sul pulsante Aggiungi.

  3. Immettere o selezionare i seguenti valori nei campi specifici.

    • Nome: My OCI Credentials
    • Organizzazione: Default
    • Tipo di credenziale: Oracle Cloud Infrastructure

    olam2-oci-cred1

    La pagina aggiorna e richiede le informazioni di configurazione OCI.

  4. Aprire una nuova finestra del terminale.

  5. Visualizzare il contenuto del file di configurazione OCI.

    cat ~/.oci/config

  6. Utilizzare i valori mostrati nel terminale e abbinarli ai campi specifici delle credenziali OCI nell'interfaccia utente Web di Oracle Linux Automation Manager.

    Utilizzare l'icona olam2-webui-show accanto a ciascun campo per visualizzare il valore dell'operazione Incolla.

    olam2-oci-cred2

  7. Ottieni il contenuto della chiave privata API dell'utente OCI.

    Nell'ambiente di laboratorio gratuito è possibile eseguire cat ~/.oci/oci.key per ottenere queste informazioni, quindi copiare l'intero output, incluse le righe BEGIN e END.

  8. Incollare la chiave nel campo Private User Key all'interno dell'interfaccia utente Web di Oracle Linux Automation Manager.

    olam2-oci-cred3

  9. Rivedere e fare clic sul pulsante Salva.

    olam2-oci-cred4

    Se è necessario modificare questi valori in un secondo momento, questi verranno visualizzati cifrati nell'interfaccia utente Web. Pertanto, per apportare modifiche, fare clic sull'icona Sostituisci accanto al campo specifico e aggiungere il nuovo valore per il campo. Ripetere l'operazione in base alle esigenze, quindi fare clic sul pulsante Salva al termine dell'esecuzione delle modifiche.

Creare un inventario

  1. Fare clic su Inventari nel menu di navigazione.

  2. Fare clic sul pulsante Aggiungi e selezionare Aggiungi magazzino dall'elenco a discesa di valori.

  3. Immettere o selezionare i seguenti valori nei campi specifici.

    • Nome: My Local Inventory
    • Gruppi di istanze: piano di controllo

    La raccolta Oracle Cloud Infrastructure Ansible utilizza una connessione di rete localhost quando si utilizza Oracle Linux Automation Engine per interagire con la tenancy OCI.

  4. Rivedere e fare clic sul pulsante Salva.

    olam2-inv

Aggiungi credenziale di controllo dell'origine

  1. Fare clic su Credenziali nel menu di navigazione.

  2. Fare clic sul pulsante Aggiungi.

  3. Immettere o selezionare i seguenti valori nei campi specifici.

    • Nome: Git Server
    • Tipo di credenziale: Controllo origine

    olam2-git-cred1

    La pagina viene aggiornata, richiedendo i dettagli del tipo.

  4. Immettere il nome utente del server Git.

    • Nome utente: git

  5. Copiare e incollare il contenuto della chiave privata del server Git nel campo Chiave privata SCM.

    L'ambiente di laboratorio gratuito utilizza il file ~/.ssh/id_rsa predefinito.

    olam2-git-cred2

  6. Rivedere e fare clic sul pulsante Salva.

    olam2-git-cred3

Crea un progetto

  1. Fare clic su Progetti nel menu di navigazione.

  2. Fare clic sul pulsante Aggiungi.

  3. Immettere o selezionare i seguenti valori nei campi specifici.

    • Nome: My Project
    • Ambiente di esecuzione: OLAM EE (2.3)
    • Tipo di credenziale di controllo origine: Git

    olam2-proj1

    La pagina viene aggiornata, richiedendo i dettagli del tipo.

    • URL controllo origine: git@<ip_address_of_instance>:/git-server/repos/myproject.git
    • Diramazione controllo di origine: main
    • Credenziale di controllo origine: Server Git

    L'ambiente di laboratorio gratuito utilizza l'indirizzo IP del server git nel campo URL controllo origine.

  4. Rivedere e fare clic sul pulsante Salva.

    olam2-proj2

  5. Rivedere lo stato di sincronizzazione del progetto.

    Dopo aver creato un progetto, l'interfaccia utente Web visualizza il relativo stato nel sintetico Dettagli all'inizio della sincronizzazione. Lo stato passa da In esecuzione a Operazione riuscita se la configurazione è corretta e il server Git è raggiungibile.

    olam2-sincronizzazione-prog

Crea modello job

  1. Fare clic su Modelli nel menu di navigazione.

  2. Fare clic sul pulsante Aggiungi e selezionare Aggiungi modello di job dall'elenco a discesa dei valori.

  3. Immettere o selezionare i valori richiesti.

    • Nome: My Template
    • Tipo di job: Esegui
    • Magazzino: Magazzino locale personale
    • Progetto: Progetto personale
    • Ambiente di esecuzione: OLAM EE (2.3)
    • Playbook: get_namespace.yml

  4. Selezionare le credenziali

    Quando si seleziona Credenziali, viene visualizzata una finestra di dialogo popup Seleziona credenziali. Scegliere Oracle Cloud Infrastructure dall'elenco a discesa Categoria selezionata per visualizzare le credenziali di quel tipo.

  5. Selezionare Credenziali OCI personali, quindi fare clic sul pulsante Seleziona.

  6. Rivedere le voci Modello job.

    olam2-temp1

  7. Scorrere la pagina e fare clic sul pulsante Salva.

    olam2-temp2

  8. Avviare il modello.

    Avviare un job dalla pagina di riepilogo del modello facendo clic sul pulsante Avvia.

    olam2-avvio-temp

    In caso di esito positivo, il job viene avviato e visualizza l'output del modello, incluso lo spazio di nomi della tenancy OCI. Se necessario, è possibile fare clic sul collegamento Ricarica output per aggiornare il pannello di output.

    olam2-output-temp

Passi successivi

L'output che mostra lo spazio di nomi conferma la disponibilità di una configurazione e di un progetto funzionanti che dimostrino come utilizzare i playbook utilizzando la raccolta Oracle Cloud Infrastructure Ansible. Sperimenta ulteriormente la raccolta per distribuire istanze e altre risorse nella tua tenancy.

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti gratuiti sulla formazione su Oracle Learning YouTube channel. Inoltre, visita education.oracle.com/learning-explorer per diventare un Oracle Learning Explorer.

Per la documentazione del prodotto, visita l'Oracle Help Center.