Nota

Utilizza OCI Functions e Python per aprire i ticket in Jira Service Management

Introduzione

L'esercitazione riportata di seguito è rivolta agli utenti di Oracle Cloud Infrastructure (OCI) che utilizzano sia il servizio di monitoraggio OCI che Jira Service Management per aprire i ticket e tenere traccia degli incidenti. Si supponga di disporre di un'istanza OCI e di voler sapere quando l'istanza diventa inattiva a causa di un errore. Si desidera ricevere una notifica e aprire immediatamente un ticket in Jira Service Management in modo che il tecnico in servizio possa iniziare a indagare e risolvere il problema il prima possibile. Utilizzando il servizio OCI Functions, i ticket possono essere aperti automaticamente in Jira Service Management quando vengono rilevati problemi con i sistemi dell'organizzazione.

Obiettivi

Prerequisiti

Task 1: creare una rete cloud virtuale

Una rete cloud virtuale (VCN) è una rete definita in OCI. Include subnet, tabelle di instradamento e gateway.

  1. Fare clic sul menu Servizi Menu Servizi accanto all'angolo in alto a sinistra della console OCI.

  2. In Networking selezionare Reti cloud virtuali.

  3. Nella pagina Reti cloud virtuali fare clic su Avvia procedura guidata VCN.

  4. Selezionare Crea VCN con connettività Internet e fare clic su Avvia procedura guidata VCN.

  5. Completare la configurazione della VCN, fare clic su Avanti e su Crea.

Task 2: creare un gruppo dinamico

I gruppi dinamici ti consentono di raggruppare le istanze di OCI Compute come attori principali (simili ai gruppi di utenti).

Nota: per creare gruppi dinamici è necessario disporre dei privilegi di amministratore.

  1. Dal menu Servizi, passare a Identità e sicurezza, Identità e fare clic su Gruppi dinamici.

  2. Fare clic su Crea gruppo dinamico.

  3. Immettere un nome e una descrizione significativi.

  4. Nella sezione Regola 1, aggiungere la riga seguente:

    ALL {resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1', instance.compartment.id = 'ocid1.compartment.oc1'}

    Nota: sostituire l'ID compartimento con l'ID compartimento desiderato.

  5. Fare clic su Crea.

Task 3: Crea criteri IAM OCI

Oracle Cloud Infrastructure Identity and Access Management (OCI IAM) ti consente di controllare chi ha accesso alle tue risorse cloud. Affinché questa integrazione funzioni, è necessario concedere l'accesso per i servizi Function as a service (FaaS) (servizio di funzione) al vault, ai repository e a diversi altri servizi.

  1. Dal menu Servizi, passare a Identità e sicurezza, Identità e fare clic su Criteri.

  2. Fare clic su Crea criterio.

  3. Immettere un nome e una descrizione appropriati e assicurarsi di selezionare il compartimento corretto. In questo esempio verrà utilizzato il compartimento denominato DEV.

  4. Nella sezione Costruzione guidata criteri, assicurarsi di abilitare Mostra editor manuale e aggiungere le righe seguenti:

    Allow service faas to read repos in tenancy

Allow service faas to read secret-family in compartment DEV

Allow service faas to read vaults in compartment DEV

Allow service faas to use keys in compartment DEV

Allow service faas to use apm-domains in compartment DEV

Allow dynamic-group DGNAME to read secret-family in compartment DEV

Allow dynamic-group DGNAME to read vaults in compartment DEV

Allow dynamic-group DGNAME to use keys in compartment DEV

    Nota: sostituire il nome del gruppo dinamico (DGNAME) e il nome del compartimento (DEV) con i nomi desiderati.

  5. Fare clic su Crea.

Task 4: Creare un repository per memorizzare la funzione

OCI Container Registry ti consente di memorizzare, condividere e gestire le immagini dei container (ad esempio le immagini Docker) in un registro gestito da Oracle.

  1. Andare a OCI Console, aprire il menu del servizio e fare clic su Servizi di sviluppo. In Container fare clic su Container di registro.

  2. Fare clic su Crea repository.

  3. Nella finestra di dialogo Crea repository, specificare Compartimento e Nome repository di propria scelta e lasciare il campo Privato.

  4. Fare clic su Crea repository.

Task 5: creare un vault per memorizzare l'utente e il token API per il login a Jira Service Management

Oracle Cloud Infrastructure Vault è un servizio di gestione delle chiavi che memorizza e gestisce le chiavi di cifratura master e i segreti per l'accesso sicuro alle risorse.

  1. Aprire il menu del servizio, fare clic su Identità e sicurezza e Vault.

  2. Fare clic su Crea vault.

  3. Nella finestra di dialogo Crea vault, selezionare il compartimento desiderato e immettere il nome appropriato desiderato. Puoi anche scegliere se vuoi renderlo privato o meno.

    Nota: non è possibile modificare il tipo di vault dopo la creazione del vault.

  4. Al termine, fare clic su Crea vault.

    Nota: salvare i file api-token e api-user di Jira Service Management separatamente nel vault.

Task 6: Creare un'applicazione

  1. Aprire il menu del servizio e fare clic su Servizi per sviluppatori. In Funzioni, fare clic su Applicazioni.

  2. Fare clic su Crea applicazione.

  3. Nella finestra Crea applicazione, immettere il nome dell'applicazione (ad esempio, Jira-Ticketing), selezionare la VCN creata nel task 1 e selezionare la subnet pubblica.

  4. Fare clic su Crea.

Task 7: Distribuire la funzione

Questo task utilizzerà l'archivio zip che può essere scaricato dalla sezione Prerequisiti.

  1. Selezionare l'applicazione appena creata in Task 6 dall'elenco.

  2. Nelle finestre Applicazione, seguire i passi disponibili nell'opzione Guida introduttiva in Risorse.

    Nota:

    • In questa esercitazione viene utilizzata l'impostazione di OCI Cloud Shell.

    • Nel passo 4 dell'impostazione, assicurarsi di specificare il nome del repository creato nel Task 4.

  3. Dopo aver fatto clic su Avvia Cloud Shell, nella parte inferiore della pagina verrà visualizzata una nuova finestra della shell di piccole dimensioni. Nell'angolo superiore destro della finestra, fare clic sul menu a ruota dentata e selezionare Carica.

  4. Trascinare il file jsm-ticket-function.zip che verrà caricato nella directory home.

  5. Decomprimere l'archivio utilizzando il comando seguente.

    unzip jsm-ticket-function.zip

  6. Passare alla directory delle funzioni utilizzando il comando cd jsm-ticket-function e procedere con i passi descritti in OCI Console.

Task 8: modificare la configurazione della funzione

Le funzioni hanno alcuni parametri configurabili che devono essere modificati per il corretto funzionamento della funzione.

  1. Nella console OCI, andare all'applicazione creata nel Task 6 e selezionare Funzioni dal lato sinistro in Risorse.

  2. Fare clic sul nome della funzione jsm-ticket-function.

  3. Fare clic su Configurazione in Risorse. È possibile visualizzare cinque chiavi: api-token, api-user, service_desk_id, request_type_id e vault_ocid.

    Tutte queste chiavi devono essere modificate con la configurazione:

    • api-token: nome del segreto dal vault in cui è memorizzato il token API dell'account utente di cui viene creato il ticket per conto. Per ulteriori informazioni, vedere Gestire i token API per l'account Atlassian.

    • api-user: il nome del segreto del vault è l'indirizzo e-mail dell'utente di cui verrà creato il ticket per conto è memorizzato.

    • service_desk_id: progetto in cui verrà creato il ticket.

    • request_type_id: tipo di richiesta con cui verrà creato il ticket (che deve avere un titolo e una descrizione).

    • vault_ocid: vault_ocid dove vengono memorizzati i segreti api-token e api-user.

    Il modo più rapido e semplice per ottenere service_desk_id e request_type_id è visitare il portale che si desidera utilizzare e visualizzare gli URL. Ad esempio, andare a un portale e fare clic su una richiesta da generare. Verrà visualizzato un URL simile al seguente: https://somewhere.atlassian.net/servicedesk/customer/portal/10/group/229/create/664

    I numeri sono:

    • 10 = Il portale/servicedesk.
    • 229: il gruppo di appartenenza della richiesta (utilizzato solo dalla navigazione, non è importante in REST).
    • 664: l'ID del tipo di richiesta su cui si è fatto clic.

Task 9: Sottoscrivere la funzione a un argomento

  1. Aprire il menu del servizio e fare clic su Servizi per sviluppatori. In Integrazione applicazioni, fare clic su Notifiche.

    Nota: assicurarsi di trovarsi nel compartimento giusto.

  2. Fare clic su Crea argomento.

  3. Immettere un nome appropriato e fare clic su Crea.

  4. Dopo aver creato l'argomento, selezionarlo dall'elenco degli argomenti.

  5. Nella finestra Argomenti, selezionare Sottoscrizioni dal lato sinistro in Risorse e fare clic su Crea sottoscrizione.

  6. Nella finestra Crea sottoscrizione, selezionare il protocollo da Funzioni, selezionare il compartimento, l'applicazione e la funzione creati nel Task 6.

  7. Fare clic su Crea.

Task 10: Creare un allarme per la metrica desiderata che è necessario monitorare

È possibile creare più tipi di allarmi. In questo tutorial, abbiamo scelto un allarme di assenza.

  1. Aprire il menu del servizio e fare clic su Osservabilità e gestione. In Monitoraggio, fare clic su Definizioni allarmi.

  2. Fare clic su Crea allarme.

  3. Nella pagina Crea allarme, in Definisci allarme, immettere o aggiornare le impostazioni dell'allarme.

  4. In Definisci notifiche di allarme, assicurarsi di selezionare l'argomento creato nel Task 9.

  5. Selezionare Formato messaggio come Invia messaggi Pretty JSON (testo RAW con interruzioni di riga).

  6. Fare clic su Salva allarme.

Conferme

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.