Kom igång

Den här guiden tar en ny plattform från den första inloggningen till en boundary med ett kluster och sina första användare, i den ordning som portalens guide vid första start frågar efter dem.

Logga in

Öppna portalen på https://portal.example.com och logga in. Inloggningen sköts av plattformens identitetsleverantör på https://auth.example.com.

Administratören som angavs när plattformen installerades har rollen Platform Owner, och det är den personen som den här guiden är skriven för. Alla andra har exakt den åtkomst som de har fått eller bjudits in till.

Så länge ingen boundary är vald i din webbläsare öppnar portalen Välkommen till Stackship:

• när det inte finns någon boundary som du kan se startar guiden med Skapa din första Boundary;
• när det finns boundaries visas Välj en Boundary: välj en och välj Fortsätt, eller välj Skapa ny Boundary för att köra guiden.

Obs

Guiden skapar en boundary, vilket Platform Owner och Platform Contributor kan göra, och registrerar sedan ett kluster, vilket bara en Platform Owner kan göra. En Platform Contributor tar sig därför igenom steg 1 och nekas i steg 2 med Kunde inte ansluta Cluster; ladda om portalen, välj den nya boundaryn under Välj en Boundary och projicera den på ett registrerat kluster — se Lägg till en projektion. Om guiden öppnas för dig och du inte har någon plattformsroll har du ännu ingen roll på någon boundary, och Skapa Boundary misslyckas med Kunde inte skapa Boundary. Be ägaren till den boundary som du ska arbeta i att bjuda in dig.

Det här sätter du upp

• En boundary är den översta nivån på plattformen. Resurser, medlemmar och behörigheter hör alla till en boundary; miljöer, team eller affärsenheter får var sin. Varje ny boundary börjar också som en egen tenant — gruppen människor som loggar in för att arbeta i den.
• Ett kluster är ett Kubernetes-kluster som plattformen placerar resurser på — oftast klustret som plattformen själv körs i. En boundarys resurser kan bara placeras på kluster som boundaryn är projicerad på.
• En inbjudan är ett e-postmeddelande med en engångslänk. Den som accepterar den får rollen som den anger, med den omfattning den anger.

Steg 1: Skapa en boundary

1. Under Skapa din första Boundary anger du ett Visningsnamn, till exempel Produktion eller Acme AB.
2. Välj Skapa Boundary.

Plattformen härleder boundaryns slug — dess namn i adresser och i Kubernetes — från visningsnamnet: accenter tas bort, bokstäver görs till gemener och varje annan följd av tecken blir ett bindestreck, så Svensk Fågel blir svensk-fagel. Fältet Slug är bara en förhandsvisning; det du skriver i det används inte. Ett visningsnamn vars slug redan är upptagen avvisas.

Skapa Boundary är inaktiverad tills fältet Slug innehåller 3 till 63 gemena bokstäver, siffror och bindestreck och börjar och slutar med en bokstav eller siffra. Ett kort visningsnamn som QA ger för lite: skriv ett längre värde i fältet för att aktivera knappen. Boundaryn får ändå den slug som härleds från visningsnamnet.

För att skapa en boundary krävs boundaries/create på plattformens rot, som Platform Owner och Platform Contributor har. Mer om boundaries: Skapa en boundary.

Steg 2: Anslut ett kluster

1. Under Anslut ditt första Cluster anger du ett Klusternamn, unikt på plattformen, och en Region.
2. Svara på Var finns klustret?:
   • Klustret som Stackship körs i — standardvalet — behöver inget mer.
   • Ett fjärrkluster behöver API-URL till sin Kubernetes-API-server och sitt Klustercertifikat: CA-certifikatet, base64-kodat. Plattformen skickar vidare din egen inloggningstoken till den API-servern, så den måste lita på plattformens identitetsleverantör.
3. Välj Anslut Cluster.

Anslut Cluster gör två saker: den registrerar klustret och projicerar sedan din nya boundary på det. Om den andra delen misslyckas förblir klustret registrerat och ett nytt försök med samma namn avvisas — projicera i stället boundaryn på det registrerade klustret från boundaryn, se Lägg till en projektion.

Det här steget kräver kernel/clusters/write och boundaries/projections/manage på plattformens rot. Bara Platform Owner har båda — Platform Contributor har boundaries/projections/manage men inte kernel/clusters/write — och steget kan inte hoppas över. Guiden registrerar alltid ett kluster som nås direkt; kluster som nås via en agent, och alla senare kluster, registreras under Inställningar → Plattformsinställningar — se Anslut ett kluster.

Steg 3: Bjud in användare

Det här steget är valfritt; du kan bjuda in personer när som helst senare.

1. Välj Bjud in en användare.
2. Ange personens E-postadress.
3. Välj vilken Roll personen får. De vanligaste valen:
   • Owner — allt i boundaryn, inklusive att hantera medlemmar och bjuda in andra;
   • Contributor — allt utom att hantera medlemmar, bjuda in och tilldela roller;
   • Reader — läsbehörighet, inklusive loggar.
4. Välj Omfattning: hela boundaryn (standard), en resursgrupp eller en resurs.
5. Välj Skicka inbjudan.

Varje inbjudan som skickats listas i steget. Personerna får sin roll när de accepterar inbjudan, inte innan; hur det går till står i Bjud in en användare.

Välj Slutför uppsättning. Portalen väljer din nya boundary och öppnar den.

Tips

När du har gått vidare från ett steg ska du inte gå tillbaka och skicka det igen: då skapas en andra boundary eller ett andra kluster.

Nästa steg

• Skapa en resursgrupp
• Tilldela en roll
• Anslut en distributionskälla