Informazioni sulla configurazione di una pipeline CI/CD

Impostare l'API in Oracle Mobile Hub

Creare uno scaffold API definendo gli endpoint REST ai quali le applicazioni si connettono. Dopo aver completato lo scaffold, è possibile scaricarlo per utilizzarlo come punto di partenza per il codice API.

Quando si definiscono i metodi HTTP per gli endpoint, è possibile aggiungere risposte di esempio. A voce rigorosa, le risposte di esempio non sono necessarie perché si scriverebbe codice in un secondo momento che fornisce le risposte reali. È tuttavia possibile immettere alcune risposte di esempio per eseguire il test dell'API prima che il codice personalizzato sia pronto.

Eseguire il login a Oracle Mobile Hub e aprire il pannello di navigazione.
Nella sezione Applicazioni del pannello di navigazione, fare clic su API.
Fare clic su Nuova API e, nel menu visualizzato, fare clic su API.
Viene visualizzata la finestra Nuova API.
Nel campo Nome visualizzato API e nel campo Nome API immettere un nome adeguato per l'interfaccia API.
Nel campo Descrizione breve immettere una descrizione appropriata.
Se si dispone di un documento RAML per l'interfaccia API, caricarlo qui.
Fare clic su Crea e viene visualizzata la pagina della nuova API.
Aggiungere le risorse HTTP. Se si è caricato un documento RAML, è possibile saltare questo passo.
1. Fare clic su Endpoint, quindi su Nuova risorsa per creare il primo endpoint e definire i relativi metodi HTTP.
2. Continuare a definire gli endpoint e i metodi HTTP per l'interfaccia API finché non vengono definiti tutti gli endpoint.
Fare clic su Salva.

Imposta il backend

Creare il backend che verrà utilizzato dall'interfaccia API. Il backend instrada le richieste dalle applicazioni all'API e fornisce i servizi di autenticazione.

Nel pannello di navigazione di Oracle Mobile Hub fare clic su Backend, che consente di visualizzare la pagina Backend.
Fare clic su Nuovo backend e, nella finestra, visualizzata, immettere un nome adeguato nel campo Nome, quindi fare clic su Crea.
Viene visualizzata la pagina di configurazione del backend. Dispone di un proprio pannello di navigazione, aperto nella pagina Impostazioni.
Nel pannello di navigazione per la pagina di configurazione fare clic su API e nella pagina visualizzata fare clic su Seleziona API per aprire il catalogo API.
Nel catalogo, trovare la scheda per l'API creata e fare clic sul pulsante + corrispondente. Questa operazione associa l'interfaccia API a questo backend.

Registra informazioni su backend e dettagli istanza

Registrare le informazioni necessarie quando si configura gli strumenti di sviluppo.

Le informazioni vengono utilizzate in un file denominato toolsConfig.json ed è richiesto per l'autenticazione. Consente a uno script di connettersi a Oracle Mobile Hub e di distribuirvi gli artifact di codice.

Nel pannello di navigazione di Oracle Mobile Hub fare clic su Backend, che consente di visualizzare la pagina Backend.
Selezionare il backend e fare clic su Apri.
Nel pannello di navigazione, fare clic su Impostazioni.
Registrare le seguenti informazioni e copiarle in un file di testo o in un altro punto in cui è possibile recuperarle in un secondo momento.
- ID client
- Segreto client
- ID backend
- Nome backend
- Versione backend
- Chiave anonima
Nel pannello di navigazione fare clic su Sviluppo per aprire la pagina principale, quindi fare clic su Dettagli istanza per aprire il pannello Dettagli istanza.
Registrare le informazioni riportate di seguito e conservarle con le informazioni backend registrate in un passo precedente.
- ID client applicazione membro team
- Segreto client applicazione membro team

Configurazione di un progetto in Oracle Developer Cloud Service

Creare un progetto che include un repository Git. In seguito, il progetto verrà configurato per eseguire una build ogni volta che si esegue il commit nel repository.

Creazione di un progetto

Creare un progetto che include un repository Git.

Accedere alla console di Oracle Developer Cloud Service e fare clic su Nuovo progetto.
Nella pagina Dettagli progetto, immettere un nome per il progetto e fare clic su Avanti.
Nella pagina Modello selezionare Repository iniziale e fare clic su Successivo.
Nella pagina Proprietà progetto accettare i valori predefiniti e fare clic su Fine per avviare il processo di provisioning.

Dopo aver fornito il progetto, la schermata deve essere simile alla seguente immagine:

Duplica e configura il repository Git

Duplicare il repository nel sistema di sviluppo locale.

Eseguire il login a Oracle Developer Cloud Service e accedere alla pagina del progetto.
Copia l'indirizzo HTTP dal campo per il repository per Git.
Aprire una finestra terminale (su Linux o Mac) o il terminale Bash Git (su Windows) e creare una nuova directory in una posizione pratica sul disco rigido. Utilizzare un nome per la directory appropriato al progetto.
```
 mkdir <your-directory-name>
```
Passare alla directory e copiare il repository, sostituendo l'indirizzo del repository nell'esempio con la propria.
```
cd <your-directory-name>
git clone <your-repo-url>
```
Quando viene richiesto di immettere una password, utilizzare la password utilizzata per eseguire il login a Oracle Developer Cloud Service.
Modifica della directory creata dal processo di duplicazione.
```
cd <your-directory-name>
```
Impostare il nome e l'indirizzo di posta elettronica per questo progetto e configurare Git per la memorizzazione delle credenziali.
```
git config user.name "<your-name>"
git config user.email "<your-email-address>"
git config credential.helper store
```

Crea un nuovo job di build

Creare un job che verrà eseguito ogni volta che si esegue il PUSH del codice nel repository Git del progetto.

Eseguire il login a Oracle Developer Cloud Service e accedere alla pagina del progetto.
Nel pannello di navigazione fare clic su Genera e nella pagina visualizzata fare clic su Nuovo job.
Immettere un nome e selezionare un modello di software, quindi fare clic su Crea job.
Fare clic su Aggiungi controllo versione e selezionare Git.
Nell'elenco a discesa Repository selezionare il repository Git che si desidera utilizzare.
Facoltativo: se si è l'unico sviluppatore che esegue il push del codice nel repository, selezionare Esegui automaticamente build al commit di SCM.

Se numerose persone lavorano sul progetto e si esegue il push del codice nel repository, non selezionare questa opzione. È possibile invece impostare un trigger di polling SCM, che può essere eseguito dopo aver creato il job di creazione.
Fare clic su Salva.

Configura trigger di polling SCM

È possibile impostare un polling che verifica la presenza di modifiche al repository Git mediante una pianificazione definita. Se vengono rilevate modifiche, viene avviata una build.

Gli unici sviluppatori che hanno eseguito il push del codice nel repository possono creare il codice immediatamente. Tuttavia, quando il codice di push verrà eseguito da diverse persone, è possibile impostare un trigger di polling che verifica periodicamente la presenza di modifiche nel repository prima di avviare una build.

Per impostare il trigger di polling di SCM, utilizzare il formato crontab per impostare una pianificazione di polling. Se non si ha familiarità con il formato crontab, è possibile utilizzare l'interfaccia grafica per creare la pianificazione.

La pianificazione predefinita è ogni 30 minuti, rappresentata da 0/30 * * * *. Per impostare l'esecuzione della pianificazione su 30 minuti dopo l'ora, utilizzare 30 * * * *.

Eseguire il login alla console di Oracle Developer Cloud Service e aprire il progetto.
Nel pannello di navigazione fare clic su Genera, quindi selezionare la build per la quale si desidera impostare i parametri.
Viene visualizzata la pagina Impostazioni di generazione.
Fare clic su Configura.
Viene visualizzata la pagina Configurazione job.
Fare clic sull'icona a forma di ingranaggio , quindi fare clic su Trigger per aprire il pannello Configura trigger build.
Fare clic sull'elenco a discesa Aggiungi trigger e selezionare Trigger di polling di SCM.
Impostare la programmazione e fare clic su Salva.

Impostazione dei parametri di creazione

Impostare un parametro stringa e un parametro password in modo che contenga il nome utente e la password per l'account Oracle Mobile Hub.

Tenere traccia dei nomi di questi parametri in quanto saranno necessari in un secondo momento quando si configurano gli strumenti degli sviluppatori.

Eseguire il login alla console di Oracle Developer Cloud Service e aprire il progetto.
Nel pannello di navigazione fare clic su Genera, quindi selezionare la build per la quale si desidera impostare i parametri.
Viene visualizzata la pagina Impostazioni di generazione.
Fare clic su Configura.
Viene visualizzata la pagina Configurazione job.
Fare clic sulla scheda Parametri build.
Fare clic sull'elenco a discesa Aggiungi parametro di creazione e selezionare Parametro stringa.
Immettere un nome per il parametro del nome utente. Ad esempio,devUser.
Nel campo Valore predefinito immettere il nome utente per Oracle Mobile Hub. Ad esempio,samir.developer@example.com.
Fare clic sull'elenco a discesa Aggiungi parametro di creazione e selezionare Parametro password.
Immettere un nome per il parametro password, ad esempio devPassword.
Nel campo Valore predefinito immettere la password per il nome utente di Oracle Mobile Hub.
Fare clic su Salva.

Configurare la Costruzione guidata shell Unix

La Costruzione guidata shell è uno script Bash che viene eseguito sul sistema di creazione ogni volta che viene attivata una build. Installa le dipendenze, quindi distribuisce il codice a Oracle Mobile Hub.

Lo script viene eseguito sull'origine del repository Git impostato durante la creazione del progetto in Oracle Developer Cloud Service. Tenere presente che se lo script non riesce in alcun momento, viene chiuso con un errore e non viene distribuito alcun codice.

Eseguire il login alla console di Oracle Developer Cloud Service e aprire il progetto.
Nel pannello di navigazione fare clic su Genera, quindi selezionare la build per la quale si desidera impostare i parametri.
Viene visualizzata la pagina Impostazioni di generazione.
Fare clic su Configura.
Viene visualizzata la pagina Configurazione job.
Fare clic sulla scheda Costruzioni guidate.
Fare clic sull'elenco a discesa Aggiungi builder e selezionare Costruzione guidata shell Unix.

Nel campo Script immettere lo script seguente:

export NODE_PATH=node-configurations/8.9/node_modules
npm install
cd omce-tools
npm install
cd node-configurations/8.9
npm install
cd ../..
node omce-deploy ../toolsConfig.json -u $devUser -p $devPassword

Fare clic su Salva.

Scarica Scaffold JavaScript

Dopo aver creato la struttura dell'interfaccia API, il sistema crea uno scaffold per il codice API che può essere scaricato in un file ZIP.

Lo scaffold contiene la struttura iniziale e i file per l'implementazione dell'API, che verranno utilizzati come punto di partenza per le personalizzazioni. È necessario estrarre i file e inserirli nella directory di lavoro.

In Oracle Mobile Hub, aprire l'API per la quale si desidera lo scaffold.
Nel pannello di navigazione API fare clic su Implementazione.
Fare clic su Scaffold JavaScript, che scarica lo scaffold file nel computer.
Estrarre package.json, toolsConfig.json e il file .js dell'interfaccia API nella directory di lavoro. Si tratta della stessa directory creata durante la duplicazione del repository Git e che contiene la directory .git.

Installare e configurare gli strumenti di sviluppo

Oracle fornisce strumenti per il caricamento di implementazioni API personalizzate in Oracle Mobile Hub dalla riga di comando. Aggiungere gli strumenti al repository Git in modo che siano disponibili per lo script di creazione su Oracle Developer Cloud Service.

Gli strumenti fanno parte di un download che contiene anche un'interfaccia API Oracle Mobile Hub che è possibile utilizzare per eseguire test e il debug delle implementazioni API personalizzate nel sistema di sviluppo in uso. L'interfaccia API non è necessaria per l'uso della pipeline CI/CD. Per istruzioni sull'uso dell'interfaccia API, denominata OracleMobileAPI, vedere il file Readme all'interno della directory omce-tools.

Gli strumenti supportano due versioni di Node.js: 6.10.0 e 8.9.x. In questa procedura si presuppone che venga utilizzata la versione 8.9.4 o successiva.

Per installare e configurare gli strumenti, procedere come segue.

Andare alla versione https://www.oracle.com/technetwork/topics/cloud/downloads/amce-downloads-4478270.html e scaricare Custom Code Test Tools versione 18.3.1 o successiva. I nomi file in questa pagina continuano a seguire i nomi dei prodotti precedenti, ma il codice che contengono è aggiornato con la release più recente. Allo stesso modo per i nomi degli strumenti all'interno del download.
Aprire il file scaricato ed estrarre il contenuto della directory omce-tools/omce-tools nella directory di lavoro, la directory che contiene la directory .git. Ad esempio, se la directory di lavoro è test-project, estrarre il contenuto di omce-tools/omce-tools in test-project/omce-tools.
Installare la configurazione del nodo: passare alla directory omce-tools/node-configurations/8.9 ed eseguire npm install.
Installa omce-tools nel sistema: passare alla directory omce-tools ed eseguire npm install -g.
Creare una variabile di ambiente denominata NODE_PATH e impostarla su node-configurations/8.9/node_modules.
Assicurarsi che gli strumenti siano installati correttamente. Nella directory omce-tools, eseguire node omce-test --version. Il risultato deve essere 18.3.1.
Aggiornare toolsConfig.json. Quando lo scaffold è stato scaricato, è incluso il file di configurazione toolsConfig.json. Utilizzare le informazioni registrate dal backend per sostituire il testo segnaposto in toolsConfig.json.