Info zum Konfigurieren einer CI/CD-Pipeline

API in Oracle Mobile Hub einrichten

Erstellen Sie ein API-scaffold, indem Sie die REST-Endpunkte definieren, mit denen Ihre Apps verbunden sind. Nachdem Sie das scaffold abgeschlossen haben, können Sie seine Definition herunterladen, um es als Ausgangspunkt für Ihren API-Code zu verwenden.

Beim Definieren der HTTP-Methoden für Ihre Endpunkte können Sie Beispielantworten hinzufügen. Es sind keine Beispielantworten erforderlich, da Sie später Code schreiben, der die tatsächlichen Antworten bereitstellt. Möglicherweise möchten Sie jedoch einige Beispielantworten für das Testen der API eingeben, bevor Ihr benutzerdefinierter Code bereit ist.

Melden Sie sich bei Oracle Mobile Hub an, und öffnen Sie den Navigationsbereich.
Klicken Sie im Navigationsbereich im Bereich "Anwendungen " auf APIs .
Klicken Sie auf Neue API, und klicken Sie im geöffneten Menü auf API.
Das Fenster Neue API wird geöffnet.
Geben Sie im Feld API-Anzeigename und im Feld API-Name einen geeigneten Namen für die API ein.
Geben Sie im Feld Kurzbeschreibung eine geeignete Beschreibung ein.
Wenn Sie ein RAML-Dokument für Ihre API haben, laden Sie es hier hoch.
Klicken Sie auf Erstellen , und die Seite für die neue API wird geöffnet.
Fügen Sie HTTP-Ressourcen hinzu. Wenn Sie ein RAML-Dokument hochgeladen haben, können Sie diesen Schritt überspringen.
1. Klicken Sie auf Endpunkte und anschließend auf Neue Ressource , um den ersten Endpunkt zu erstellen und die zugehörigen HTTP-Methoden zu definieren.
2. Setzen Sie die Definition der Endpunkte und HTTP-Methoden für die API fort, bis alle Endpunkte definiert sind.
Klicken Sie auf Speichern .

Backend einrichten

Erstellen Sie das Backend, das Ihre API verwendet. Das Backend leitet Anforderungen von Ihren Apps an die API weiter und stellt Authentifizierungsservices bereit.

Klicken Sie im Oracle Mobile Hub-Navigationsbereich auf Backends , um die Seite "Backends " zu öffnen.
Klicken Sie auf Neues Backend , und geben Sie in dem daraufhin geöffneten Fenster einen entsprechenden Namen in das Feld Name ein. Klicken Sie dann auf Erstellen .
Die Backend-Konfigurationsseite wird geöffnet. Sie verfügt über einen eigenen Navigationsbereich, der auf der Seite "Einstellungen " geöffnet wird.
Klicken Sie im Navigationsbereich für die Konfigurationsseite auf APIs , und klicken Sie auf der daraufhin geöffneten Seite auf APIs auswählen. Dadurch wird der API-Katalog geöffnet.
Suchen Sie im Katalog die Karte für die von Ihnen erstellte API, und klicken Sie auf die Schaltfläche + . Dadurch wird diese API mit diesem Backend verknüpft.

Informationen zu Backend- und Instanzdetails aufzeichnen

Erfassen Sie Informationen, die Sie bei der Konfiguration des Entwicklungstools benötigen.

Die Informationen werden in einer Datei namens toolsConfig.json verwendet und sind zur Authentifizierung erforderlich. Mit ihr kann ein Skript eine Verbindung zu Oracle Mobile Hub herstellen und Code-Artefakte damit bereitstellen.

Klicken Sie im Oracle Mobile Hub-Navigationsbereich auf Backends , um die Seite "Backends " zu öffnen.
Wählen Sie das Backend, und klicken Sie auf Öffnen .
Klicken Sie im Navigationsbereich auf Einstellungen .
Notieren Sie die folgenden Informationen, und kopieren Sie sie in eine Textdatei oder an eine andere Stelle, an der Sie sie später problemlos abrufen können:
- Client-ID
- Client Secret
- Backend-ID
- Backend-Name
- Backend-Version
- Anonymer Schlüssel
Klicken Sie im Navigationsbereich auf Entwicklung , um die Hauptseite zu öffnen. Danach klicken Sie auf Instanzdetails , um den Fensterbereich "Instanzdetails " zu öffnen.
Folgende Informationen aufzeichnen und die Backend-Informationen beibehalten, die Sie im vorherigen Schritt aufgezeichnet haben:
- Client-ID des Teammitglieds
- Client Secret von Teammitglieds-App

Projekt in Oracle Developer Cloud Service einrichten

Erstellen Sie ein Projekt, das ein Git-Repository enthält. Später konfigurieren Sie das Projekt so, dass es erstellt wird, wenn Sie einen Commit an das Repository übertragen.

Projekt erstellen

Erstellen Sie ein Projekt, das ein Git-Repository enthält.

Melden Sie sich bei der Oracle Developer Cloud Service-Konsole an, und klicken Sie auf Neues Projekt .
Geben Sie auf der Seite Projektdetails einen Namen für das Projekt ein, und klicken Sie auf Weiter .
Wählen Sie auf der Seite Vorlage die Option Anfängliches Repository , und klicken Sie auf Weiter .
Übernehmen Sie auf der Seite "Projekteigenschaften " die Standardwerte, und klicken Sie auf Fertigstellen , um den Provisioning-Prozess zu starten.

Nachdem das Projekt bereitgestellt wurde, sollte Ihr Bildschirm dem folgenden Bild ähneln:

Git-Repository klonen und konfigurieren

Klonen Sie das Repository in Ihrem lokalen Entwicklungssystem.

Melden Sie sich bei Oracle Developer Cloud Service an, und navigieren Sie zur Projektseite.
Kopieren Sie die HTTP-Adresse aus dem Feld für das Repository für Git.
Öffnen Sie ein Terminalfenster (unter Linux oder Mac) oder das Git-Bash-Terminal (unter Windows), und erstellen Sie ein neues Verzeichnis an einem geeigneten Ort auf Ihrer Festplatte. Verwenden Sie einen Namen für das Verzeichnis, das für Ihr Projekt geeignet ist.
```
 mkdir <your-directory-name>
```
Wechseln Sie zum Verzeichnis, und klonen Sie das Repository, und ersetzen Sie die Repository-Adresse im Beispiel durch eine eigene.
```
cd <your-directory-name>
git clone <your-repo-url>
```
Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, verwenden Sie das Kennwort, das Sie zur Anmeldung bei Oracle Developer Cloud Service verwenden.
Wechseln Sie zu dem Verzeichnis, das von dem Cloning-Prozess erstellt wurde.
```
cd <your-directory-name>
```
Legen Sie Ihren Namen und Ihre E-Mail-Adresse für dieses Projekt fest, und konfigurieren Sie Git zur Speicherung Ihrer Zugangsdaten.
```
git config user.name "<your-name>"
git config user.email "<your-email-address>"
git config credential.helper store
```

Neuen Build-Job erstellen

Erstellen Sie einen Job, der jedes Mal ausgeführt wird, wenn Sie Code in das Git-Repository des Projekts übertragen.

Melden Sie sich bei Oracle Developer Cloud Service an, und navigieren Sie zur Projektseite.
Klicken Sie im Navigationsbereich auf Erstellen , und klicken Sie auf der Seite, die geöffnet wird, auf Neuer Job .
Geben Sie einen Namen ein, und wählen Sie eine Softwarevorlage, und klicken Sie dann auf Job erstellen.
Klicken Sie auf Versionskontrolle hinzufügen , und wählen Sie Git .
Wählen Sie In der Dropdown-Liste Repository das gewünschte Git-Repository aus.
Optional: Wenn Sie der einzige Entwickler sind, der Code in das Repository überträgt, wählen Sie Build bei SCM Commit automatisch ausführen aus.

Wenn mehrere Personen am Projekt arbeiten und Code in das Repository pushen, wählen Sie diese Option nicht. Sie können stattdessen einen SCM-Polling-Trigger einrichten, den Sie nach dem Erstellen des Build-Jobs ausführen können.
Klicken Sie auf Speichern .

SCM-Polling-Trigger konfigurieren

Sie können eine Abstimmung einrichten, die nach Änderungen am Git-Repository in einem von Ihnen definierten Zeitplan prüft. Wenn Änderungen ermittelt werden, wird ein Build gestartet.

Wenn Sie nur der Entwickler sind, der Code in das Repository überträgt, ist wahrscheinlich ein sofortiges Build geeignet. Wenn jedoch mehrere Personen Code anstoßen, können Sie einen Polling-Trigger einrichten, der regelmäßig auf Änderungen im Repository prüft, bevor Sie einen Build starten.

Um den SCM-Polling-Trigger einzurichten, verwenden Sie das crontab-Format, um einen Polling-Ausführungsplan festzulegen. Wenn Sie mit dem crontab-Format nicht vertraut sind, können Sie den Ausführungsplan mit der grafischen Oberfläche erstellen.

Der Standard-Ausführungsplan ist alle 30 Minuten, dargestellt durch 0/30 * * * *. Um den Ausführungsplan festzulegen, der um 30 Minuten nach der Stunde ausgeführt wird, verwenden Sie 30 * * * *.

Melden Sie sich bei der Oracle Developer Cloud Service-Konsole an, und öffnen Sie Ihr Projekt.
Klicken Sie im Navigationsbereich auf Erstellen , und wählen Sie den Build, für den Sie die Parameter festlegen möchten.
Die Seite Build-Einstellungen wird geöffnet.
Klicken Sie auf Konfigurieren.
Die Seite "Jobkonfiguration " wird geöffnet.
Klicken Sie auf das Zahnradsymbol , und klicken Sie dann auf Trigger , um den Bereich "Erstellungstrigger konfigurieren " zu öffnen.
Klicken Sie auf die Dropdown-Liste Trigger hinzufügen , und wählen Sie SCM Polling-Trigger .
Legen Sie den Ausführungsplan fest, und klicken Sie auf Speichern .

Build-Parameter einrichten

Richten Sie einen Zeichenfolgenparameter und einen Kennwortparameter so ein, dass der Benutzername und das Kennwort für Ihren Oracle Mobile Hub-Account gespeichert werden.

Verfolgen Sie die Namen dieser Parameter, da Sie sie später bei der Konfiguration des Entwicklertools benötigen.

Melden Sie sich bei der Oracle Developer Cloud Service-Konsole an, und öffnen Sie Ihr Projekt.
Klicken Sie im Navigationsbereich auf Erstellen , und wählen Sie den Build, für den Sie die Parameter festlegen möchten.
Die Seite Build-Einstellungen wird geöffnet.
Klicken Sie auf Konfigurieren.
Die Seite "Jobkonfiguration " wird geöffnet.
Klicken Sie auf die Registerkarte Build-Parameter .
Klicken Sie auf die Dropdown-Liste Build-Parameter hinzufügen , und wählen Sie Zeichenfolgenparameter aus.
Geben Sie einen Namen für den Benutzernamenparameter ein. Beispiel: devUser.
Geben Sie im Feld Standardwert Ihren Oracle Mobile Hub-Benutzernamen ein. Beispiel: samir.developer@example.com.
Klicken Sie auf die Dropdown-Liste Build-Parameter hinzufügen , und wählen Sie Kennwortparameter aus.
Geben Sie einen Namen für den Kennwortparameter ein, wie devPassword .
Geben Sie im Feld Standardwert das Kennwort für den Oracle Mobile Hub-Benutzernamen ein.
Klicken Sie auf Speichern .

Unix Shell Builder konfigurieren

Der Shell Builder ist ein Bash-Skript, das auf dem Erstellsystem ausgeführt wird, wenn ein Build ausgelöst wird. Sie installiert Abhängigkeiten und stellt dann Ihren Code für Oracle Mobile Hub bereit.

Das Skript wird für die Quelle aus dem Git-Repository ausgeführt, das Sie beim Erstellen des Projekts in Oracle Developer Cloud Service eingerichtet haben. Wenn das Skript zu einem beliebigen Zeitpunkt ausfällt, wird ein Fehler angezeigt, und es wird kein Code bereitgestellt.

Melden Sie sich bei der Oracle Developer Cloud Service-Konsole an, und öffnen Sie Ihr Projekt.
Klicken Sie im Navigationsbereich auf Erstellen , und wählen Sie den Build, für den Sie die Parameter festlegen möchten.
Die Seite Build-Einstellungen wird geöffnet.
Klicken Sie auf Konfigurieren.
Die Seite "Jobkonfiguration " wird geöffnet.
Klicken Sie auf die Registerkarte Builder .
Klicken Sie auf die Dropdown-Liste Builder hinzufügen , und wählen Sie Unix Shell Builder .

Geben Sie im Feld Skript das folgende Skript ein:

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

Klicken Sie auf Speichern .

JavaScript-Gerüst herunterladen

Nachdem Sie das API-Skeleton erstellt haben, erstellt das System ein scaffold für den API-Code, den Sie in eine ZIP-Datei herunterladen können.

Das scaffold enthält die Ausgangsstruktur und die Dateien für die Implementierung der API, die Sie als Ausgangspunkt für Ihre Anpassungen verwenden. Sie müssen die Dateien extrahieren und in Ihrem Arbeitsverzeichnis speichern.

Öffnen Sie In Oracle Mobile Hub die API, für die das scaffold gelten soll.
Klicken Sie im API-Navigationsbereich auf Implementierung .
Klicken Sie auf JavaScript-Gerüst , um die scaffalte-Datei auf Ihren Computer herunterzuladen.
Extrahieren Sie die Datei package.json, toolsConfig.json und .js für Ihre API in Ihr Arbeitsverzeichnis. Es ist dasselbe Verzeichnis, das beim Klonen des Git-Repositorys erstellt wurde und das Verzeichnis .git enthält.

Entwicklungstools installieren und konfigurieren

Oracle stellt Tools für das Hochladen von benutzerdefinierten API-Implementierungen aus der Befehlszeile in Oracle Mobile Hub bereit. Fügen Sie die Tools dem Git-Repository hinzu, damit sie Ihrem Build-Skript in Oracle Developer Cloud Service zur Verfügung stehen.

Die Tools sind Bestandteil eines Downloads, der auch eine Oracle Mobile Hub-API enthält, mit der Sie Ihre benutzerdefinierten API-Implementierungen in Ihrem Entwicklungssystem testen und debuggen können. Die API ist nicht zur Verwendung der CI/CD-Pipeline erforderlich. Anweisungen zur Verwendung der API, die als OracleMobileAPI bezeichnet wird, finden Sie in der Readme-Datei im Verzeichnis omce-tools.

Die Tools unterstützen zwei Versionen von Node.js: 6.10.0 und 8.9.x. In dieser Prozedur wird davon ausgegangen, dass Sie Version 8.9.4 oder höher verwenden.

So installieren und konfigurieren Sie das Tooling:

Gehen Sie zu https://www.oracle.com/technetwork/topics/cloud/downloads/amce-downloads-4478270.html , und laden Sie die benutzerdefinierten Codetest-Tools Version 18.3.1 oder höher herunter. Beachten Sie, dass die Dateinamen auf dieser Seite weiterhin den Legacy-Produktnamen entsprechen, der enthaltene Code jedoch mit dem neuesten Release auf dem neuesten Stand ist. Gleichermaßen für die Namen der Tools innerhalb des Downloads.
Öffnen Sie die Datei, die Sie heruntergeladen haben, und extrahieren Sie den Inhalt des Verzeichnisses omce-tools/omce-tools in Ihr Arbeitsverzeichnis (das Verzeichnis .git enthält). Beispiel: Wenn Ihr Arbeitsverzeichnis test-project ist, extrahieren Sie den Inhalt von omce-tools/omce-tools in test-project/omce-tools.
Installieren Sie die Knotenkonfiguration: Wechseln Sie zum Verzeichnis omce-tools/node-configurations/8.9, und führen Sie npm install aus.
Installieren Sie omce-Tools auf Ihrem System: Wechseln Sie zum Verzeichnis omce-tools, und führen Sie npm install-g aus.
Erstellen Sie eine Umgebungsvariable namens NODE_PATH, und setzen Sie sie auf node-configurations/8.9/node_modules.
Stellen Sie sicher, dass die Tools korrekt installiert sind. Führen Sie im Verzeichnis omce-tools node omce-test--version aus. Das Ergebnis muss 18.3.1.sein
Aktualisieren Sie toolsConfig.json. Wenn Sie das scaffold heruntergeladen haben, enthält es die Konfigurationsdatei toolsConfig.json. Verwenden Sie die vom Backend aufgezeichneten Informationen, um den Platzhaltertext in toolsConfig.json zu ersetzen.