Installera en komponent

Vissa backendmoduler är valfria: plattformen fungerar utan dem, och installationsprogrammet kan lämna dem utanför. En modul som inte körs kan installeras senare från Livscykelhantering, i en version från releaseflödet. För att installera krävs lifecycle/install på plattformens rot, som Platform Owner och Platform Contributor har.

En installation tar bara in något som inte körs än. För att byta version på en komponent som är installerad använder du en utrullning — se Uppgradera plattformen.

Vad som kan installeras

Installationsdialogen kontrollerar komponenten först och listar det som står i vägen under This component cannot be installed yet. En komponent kan installeras när:

• den är en backendmodul — plattformens API, operatorn, portalen och CRD-paketet kan inte installeras;
• den inte redan körs;
• releaseflödet har en release av den på plattformens kanal, låst med digest, och beskriver hur den installeras;
• den varken behöver ett eget tjänstekonto eller egna domäner — sådana moduler installeras med installationsprogrammet;
• varje värde den behöver som plattformen inte kan generera har fyllts i i dialogen.

När installationen startar kontrollerar den dessutom att:

• de komponenter den beror på är installerade;
• dess anpassade resursdefinitioner är etablerade i klustret — annars rullar du ut CRD-paketet först;
• ingen utrullning pågår — installationer och utrullningar körs inte samtidigt;
• Lifecycle-modulen kan skapa modulens inloggningsklient i identitetsleverantören, med alla roller modulen behöver. På en plattform som installationsprogrammet har byggt finns det på plats.

Installera

1. Öppna Inställningar → Livscykelhantering. På fliken Components visar en komponent som inte körs Not installed under Health och en knapp Install.
2. Välj Install. Dialogen Install <component> öppnas.
3. Välj Version; den senaste releasen är förvald.
4. Fyll i de värden modulen frågar efter. De är hemliga och skrivs till modulens hemligheter; ett värde du fyller i ersätter ett som modulens hemlighet redan har.
5. Välj Install.

Viktigt

Tills installationen har lyckats sparas värdena du fyllde i också, okrypterade, tillsammans med installationen i Lifecycle-modulens databas, så att en misslyckad installation kan återupptas. En installation som misslyckas och aldrig återupptas behåller dem där.

Varning

Om modulens identitet ännu inte är registrerad hos plattformens API startar installationen om plattformens API, och pågående anrop kan misslyckas under några sekunder.

Följ installationen

Förloppsdialogen öppnas av sig själv, och komponentens rad visar Installing… medan den körs. Installationen går igenom de här stegen, i ordning:

1. Preflight checks — allt under Vad som kan installeras.
2. Provision Keycloak client — modulens inloggningsklient i identitetsleverantören.
3. Provision secrets — modulens hemligheter. Ett värde du fyllde i dialogen skrivs; alla andra värden som redan finns behålls.
4. Apply module resources — modulens konfiguration, Service och Deployment.
5. Update kernel allowlist — låter plattformens API godta modulens identitet.
6. Wait for module readiness — tills Deploymenten är tillgänglig.
7. Finalize — registrerar komponenten i Livscykelhanterings förteckning.

Installationen registreras också som en operation. När den har lyckats visas komponenten med version och hälsa som alla andra.

När en installation misslyckas

Ett misslyckat steg stoppar installationen och visar orsaken; det som redan har tillämpats ligger kvar. Raden visar då Install failed — details. Åtgärda orsaken, öppna detaljerna och välj Resume: installationen fortsätter från steget som misslyckades. En komponent kan inte installeras igen medan en installation av den väntar, pågår eller har misslyckats.

Reparera en komponent som körs

En reparation kör samma steg mot en komponent som redan körs, för att få dess identitetsklient, hemligheter och resurser att stämma med den installationsbeskrivning som releaseflödet har för den, utan att byta version — avbildningen den kör förblir densamma. Den kräver lifecycle/install, och det finns ingen knapp för den; använd API:t, till exempel med stsh api:

stsh api POST /lifecycle/components/<component>/repair
stsh api GET /lifecycle/installs

Återuppta en misslyckad reparation som en installation: stsh api POST /lifecycle/installs/<install-id>/resume.