Free Tier: Helidon auf einer Ubuntu-Instanz einrichten
In diesem Tutorial richten Sie mit einem Oracle Cloud Infrastructure Free Tier-Account eine Ubuntu-Compute-Instanz ein. Anschließend richten Sie einen Helidon MicroProfile-(MP-)Server für Ihren Host ein.
Zu den wichtigsten Aufgaben gehören:
- Richten Sie ein Compartment für Ihre Entwicklungsarbeit ein.
- Installieren Sie Ihre Ubuntu Linux-Instanz, und verbinden Sie sie mit Ihrem virtuellen Cloud-Netzwerk (VCN).
- Richten Sie ein virtuelles Cloud-Netzwerk in Oracle Cloud Infrastructure und zugehörige Netzwerkservices ein, die für die Verbindung Ihres Hosts mit dem Internet erforderlich sind.
- Richten Sie
SSH
-Verschlüsselungsschlüssel für den Zugriff auf Ihren Ubuntu Linux-Server ein.
- Konfigurieren Sie Ingress-Regeln für das VCN.
- Installieren Sie JDK und Maven.
- Richten Sie Helidon mit dem MicroProfile-(MP-)Server ein.
- Erstellen Sie eine "Hello World"-Java-Anwendung.
- Testen Sie die Anwendung.
Im Folgenden finden Sie ein vereinfachtes Diagramm des Setups für Ihre Linux-Instanz.

Weitere Informationen finden Sie hier:
Bevor Sie beginnen
Um dieses Tutorial erfolgreich abzuschließen, benötigen Sie Folgendes:
Anforderungen
- Free Tier-Account für Oracle Cloud Infrastructure. Oracle Cloud Infrastructure Free Tier.
- MacOS-, Linux- oder Windows-Rechner mit installierter
SSH
-Unterstützung.
1. Compartment für Entwicklung einrichten
Konfigurieren Sie ein Compartment für Ihre Entwicklung.
Erstellen Sie ein Compartment für die Ressourcen, die Sie in diesem Tutorial erstellen.
- Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole an.
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Identität und Sicherheit. Klicken Sie unter Identität auf Compartments.
- Klicken Sie auf Compartment erstellen.
- Geben Sie die folgenden Informationen ein:
- Name:
<your-compartment-name>
- Beschreibung:
Compartment für <your-description>.
- Übergeordnetes Compartment:
<your-tenancy>(Root)
- Name:
- Klicken Sie auf Compartment erstellen.
Referenz: Compartment erstellen
2. Ubuntu Linux-Instanz installieren
Mit dem Workflow VM-Instanz erstellen können Sie eine neue Compute-Instanz erstellen.
Der Workflow führt bei der Installation der Instanz mehrere Schritte aus:
- Erstellt und installiert eine Compute-Instanz mit Ubuntu Linux.
- Erstellt ein VCN mit dem erforderlichen Subnetz und den erforderlichen Komponenten, um die Ubuntu Linux-Instanz mit dem Internet zu verbinden.
- Erstellt ein
SSH
-Schlüsselpaar, mit dem Sie eine Verbindung zur Instanz herstellen können.
Um mit der Installation einer Instanz mithilfe des Workflows VM-Instanz erstellen zu beginnen, gehen Sie wie folgt vor:
Die angegebenen Schritte gelten für einen Free Tier-Account. Wenn Sie einen kostenpflichtigen Account verwenden, können sich die Schritte von den hier beschriebenen unterscheiden.
3. Internetzugriff aktivieren
Der Assistent VM-Instanz erstellen erstellt automatisch ein VCN für Ihre VM. Fügen Sie dem Subnetz eine Ingress-Regel hinzu, um Internetverbindungen auf Port 8080 zuzulassen.
Führen Sie die folgenden Schritte aus, um das öffentliche Subnetz des VCN auszuwählen und die Ingress-Regel hinzuzufügen.
4. Anwendung auf Helidon-Server ausführen
Richten Sie als Nächstes Helidon auf Ihrer Ubuntu Linux-Instanz ein.
So konfigurieren Sie die Ubuntu-Firewall:
- Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
- Klicken Sie auf den Link zur Instanz, die Sie im vorherigen Schritt erstellt haben.
Suchen Sie auf der Seite Instanzdetails im Abschnitt Primäre VNIC. Kopieren Sie die öffentliche IP-Adresse, die das System erstellt hat. Mit dieser IP-Adresse können Sie eine Verbindung zu Ihrer Instanz herstellen.
- Öffnen Sie das Fenster Terminal oder Eingabeaufforderung.
- Wechseln Sie in das Verzeichnis, in dem Sie die
SSH
-Verschlüsselungsschlüssel gespeichert haben, die Sie in Teil 2 erstellt haben. - Stellen Sie mit diesem SSH-Befehl eine Verbindung zur Instanz her.
ssh -i <your-private-key-file> ubuntu@<x.x.x.x>
Da Sie den Public Key beim Erstellen der Instanz angegeben haben, werden Sie mit diesem Befehl bei der Instanz angemeldet. Sie können jetzt
sudo
-Befehle ausgeben, um den Server zu installieren und zu starten. - Aktualisieren Sie die Firewalleinstellungen.
Die Ubuntu-Firewall ist standardmäßig deaktiviert. Sie müssen jedoch Ihre
iptables
-Konfiguration aktualisieren, um HTTP-Traffic zuzulassen. Führen Sie die folgenden Befehle aus:iptables
.sudo iptables -I INPUT 6 -m state --state NEW -p tcp --dport 8080 -j ACCEPT sudo netfilter-persistent save
Die Befehle fügen eine Regel hinzu, um HTTP-Traffic über Port 8080 zuzulassen, und speichern die Änderungen an den
iptables
-Konfigurationsdateien.
- Führen Sie die folgenden Befehle aus:
sudo apt update sudo apt -y install openjdk-11-jdk-headless java -version
- Legen Sie
JAVA_HOME
in.bashrc
fest.Aktualisieren Sie die Datei:
vi .bashrc
Hängen Sie in der Datei folgenden Text an, und speichern Sie die Datei:
# set JAVA_HOME export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
- Aktivieren Sie den vorherigen Befehl im aktuellen Fenster.
source ~/.bashrc
Führen Sie die folgenden Befehle aus:
- Installieren Sie Maven.
sudo apt -y install maven
- Prüfen Sie die Maven-Installation.
mvn --version
Führen Sie den folgenden Maven Archetype aus, der zunächst eine Maven-Projektvorlage erstellt. Für dieses Projekt wird folgendes Beispiel von der Helidon-Website verwendet: Kurzanleitung "Helidon MP". Führen Sie die folgenden Befehle aus:
- Führen Sie die Helidon Maven-Installation aus. Beispiel:
mvn -U archetype:generate -DinteractiveMode=false \ -DarchetypeGroupId=io.helidon.archetypes \ -DarchetypeArtifactId=helidon-quickstart-mp \ -DarchetypeVersion=2.2.1 \ -DgroupId=io.helidon.examples \ -DartifactId=helidon-quickstart-mp \ -Dpackage=io.helidon.examples.quickstart.mp
Der Archetype erstellt ein Maven-Projekt im aktuellen Verzeichnis. Die Ausgabe sieht in etwa folgendermaßen aus:
[INFO] Project created from Archetype in dir: /home/ubuntu/helidon-quickstart-mp [INFO] BUILD SUCCESS
Hinweis
Informationen zur Installation der neuesten Version von Helidon MP finden Sie unter Kurzanleitung "Helidon MP". - Wechseln Sie in das Verzeichnis
helidon-quickstart-mp
.cd helidon-quickstart-mp
- Erstellen Sie die Anwendung.
mvn package
Sie erhalten eine Meldung, die die erfolgreiche Erstellung bestätigt.
[INFO] BUILD SUCCESS
- Führen Sie die Anwendung aus.
java -jar target/helidon-quickstart-mp.jar
Sie können Ihre Anwendung jetzt testen.
- Stellen Sie über ein neues Terminal mit Ihren SSH-Schlüsseln eine Verbindung zu Ihrer Ubuntu-Instanz her, und geben Sie dann in der Befehlszeile Folgendes ein:
curl -X GET http://localhost:8080/greet
Sie können den Browser auch mit der öffentlichen IP-Adresse verbinden, die der Instanz zugewiesen ist:
http://<x.x.x.x>:8080/greet
Sie sollten
{"message":"Hello World!"}
auf Ihrer Instanz oder in Ihrem Browser sehen. - Geben Sie einen Namen für die Begrüßung ein. Geben Sie im Terminal Folgendes ein:
curl -X GET http://localhost:8080/greet/Mike
Geben Sie alternativ im Browser Folgendes ein: http://<x.x.x.x>:8080/greet/Mike.
Auf Ihrer Instanz oder in Ihrem Browser wird
{"message":"Hello Mike!"}
angezeigt. - Aktualisieren Sie die Begrüßung. Geben Sie im Terminal Folgendes ein:
curl -X PUT -H "Content-Type: application/json" -d '{"greeting" : "Aloha"}' http://localhost:8080/greet/greeting
Der Befehl ändert das Hello in der Nachricht in Aloha.
- Testen Sie die aktualisierte Begrüßung. Geben Sie in Ihrem Browser Folgendes ein: http://<x.x.x.x>:8080/greet/Mike.
Auf Ihrer Instanz oder in Ihrem Browser wird
{"message":"Aloha Mike!"}
angezeigt. - Geben Sie die folgenden Befehle in Ihrem Browser ein, um den Zustand und die Metriken abzurufen.
http://<x.x.x.x>:8080/health http://<x.x.x.x>:8080/metrics
Um Metriken im JSON-Format abzurufen, geben Sie im Terminal Folgendes ein:
curl -H 'Accept: application/json' -X GET http://localhost:8080/metrics
Herzlichen Glückwunsch. Sie haben erfolgreich eine "Hello World"-Anwendung mit dem Helidon MicroProfile-Service auf Ihrer Oracle Cloud Infrastructure-Instanz erstellt.
Referenzen:
Detaillierte Informationen zu diesem Beispiel finden Sie unter Kurzanleitung "Helidon MP"
Weitere Schritte
Sie haben erfolgreich eine "Hello World"-Anwendung mit dem Helidon MicroProfile-Service auf Ihrer Oracle Cloud Infrastructure-Instanz erstellt.
Weitere Informationen zur Entwicklung mit Oracle-Produkten finden Sie auf folgenden Websites: