Din första app

En app är en container som Velrix håller igång åt dig. Du anger en image och en storlek. Velrix placerar appen på den server som har mest utrymme, startar den och startar om den om den stannar. I den här guiden driftsätter du en liten webbserver och tittar dig omkring.

Du behöver ett konto på en Velrix-installation med behörighet att köra appar: ditt eget, eller en organisations om din roll tillåter det.

1. Öppna Appar

Logga in och öppna Appar från startmenyn eller skrivbordet. Finns det inga appar än står det Inga appar än.

2. Driftsätt en app

Välj Ny app. Formuläret har några flikar, men för en första app räcker den första.

1. Namn: web.
2. Image: en fullständig referens, med register. Till exempel:

   docker.io/library/nginx:1.27
   

   
   Ett kort namn som nginx godtas inte: Velrix hämtar alltid från det register du anger.
3. Storlek: välj en från katalogen, till exempel g.nano. Storlekarna bestäms av den driftansvarige: varje storlek har en familj (g allmän, c beräkning, m minne) och ett namn. Med Egen anger du själv minne och CPU, i kärnor.
4. Lämna Kommando tomt så körs imagens eget kommando.

Välj Driftsätt.

Arbetar du i en organisation med projekt kan du lägga appen i ett av dem på fliken Projekt. Appar i samma projekt delar ett privat nätverk.

Eller börja från en mall. Under Bibliotek i startmenyn finns färdiga appar (nginx, PostgreSQL, Gitea med flera) med låst image och en rimlig storlek. Välj Driftsätt på en av dem, så öppnas samma formulär redan ifyllt.

3. Se den starta

Formuläret stängs och appen syns i Appar: öppna den där. Statusen går från Startar till Körs, och du ser vilken server den körs på. Fliken Driftsättningar visar driftsättningen som den första revisionen. Fliken Översikt visar hur mycket CPU och minne appen använder av det storleken ger, mätt var tionde sekund.

Om något är fel säger sidan det i klartext:

• Ingen värd: ingen server har plats för den här storleken just nu. Välj en mindre storlek, eller fråga den driftansvarige.
• Den kunde inte startas: servern kunde inte skapa containern. Kontrollera imagenamnet och att servern kan hämta imagen.
• Kraschar: den stannar direkt efter start. Sidan visar den senaste slutkoden, och Velrix försöker igen med allt längre mellanrum, som mest var femte minut.

4. Läs loggarna och öppna en terminal

• Loggar visar det appen skrivit, i realtid, med sökning och nedladdning. Skriv @level:error för att bara se fel (Appar har resten).
• Öppna en terminal ger dig ett skal inne i den körande containern, i ett eget fönster.

5. Skilj på körs och fungerar

Att en app körs betyder inte att den fungerar. En hälsokontroll är ett kommando som Velrix kör inne i containern med jämna mellanrum. Slutkod 0 betyder att den fungerar.

Välj Lägg till en kontroll under Hälsa på fliken Inställningar, och ange för den här webbservern:

wget -q -O /dev/null http://127.0.0.1/

Ställ sedan in hur ofta kontrollen körs, hur många misslyckanden i rad som ger status Sjuk, och om Velrix ska starta om appen då. Imagen måste innehålla verktyget som kommandot anropar, här wget.

Med en kontroll står det Frisk om en app som fungerar, med ett hjärta som slår på dess kort. Nya revisioner kontrolleras också: en som inte klarar sin kontroll ersätter aldrig kopian som fungerar.

6. Ge den en disk

En apps egna filer försvinner när appen tas bort. Data som ska finnas kvar lägger du på en volym.

1. Öppna Volymer och skapa en volym med namn och storlek. Velrix håller volymen inom den storleken.
2. Gå tillbaka till appen, öppna fliken Volymer, välj volymen och en Monteringssökväg i appen, till exempel /usr/share/nginx/html, och välj Koppla in.

7. Variabler och hemligheter

Fliken Variabler innehåller variablerna som appen startar med. Försegla dem som är hemligheter: ett förseglat värde krypteras, visas aldrig igen och syns bara för containern.

Ändringar förbereds: ingenting startas om förrän du väljer Driftsätt på raden som säger Verkställ 1 ändring. Då körs de som en revision, utrullad utan avbrott. Referenser till andra appar, delade variabler och skapade hemligheter finns i Appar.

Städa upp

Ta bort, sist under appens Inställningar, tar bort containern permanent. Volymerna finns kvar, frånkopplade, med sitt innehåll.

Samma app som kod

Allt ovan är också ett API-anrop, med en API-nyckel. Anropen beskrivs i API-referensen i realmens Docs-fönster:

curl https://velrix.example.com/v1/compute/app.create \
  -H "Authorization: Bearer $VELRIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "web", "image": "docker.io/library/nginx:1.27", "size": "g.nano"}'

Eller med providern för OpenTofu och Terraform, som beskrivs i realmens Docs-fönster:

resource "velrix_app" "web" {
  name       = "web"
  image      = "docker.io/library/nginx:1.27"
  memory_mib = 128
}

Nästa steg

• Appar: driftsättningar, variabler, inställningar och loggar
• Din första maskin
• Stackar: OpenTofu med godkännande