Installera GitHub-appen

Velumi GitHub-appen ger Velumi läsbehörighet till dina repositories vid byggtillfället. Du installerar den en gång per GitHub-konto (personligt eller organisation) och väljer vilka repos den kan se.

Var du ska börja

Gå från Velumi-instrumentpanelen till din organisations Integrations-sida:

Organization → Integrations → Install GitHub App

En popup öppnas på GitHub. Välj:

Var du ska installera — ditt personliga GitHub-konto eller en GitHub-organisation du administrerar
Repository-åtkomst — alla nuvarande och framtida repos, eller endast specifika

När du har slutfört flödet på GitHub stängs popupen och din installation visas i Velumi.

Personlig vs organisationsinstallation

Personligt konto — ger Velumi åtkomst till repos som ägs av din GitHub-användare
GitHub-organisation — ger Velumi åtkomst till repos som ägs av en GitHub-organisation; kräver att du är ägare av den GitHub-organisationen

Du kan installera på flera konton — till exempel ditt personliga konto och ditt företags GitHub-organisation. Varje installation listas separat i Velumi-instrumentpanelen.

Alla medlemmar i din Velumi-organisation kan deploya från repositories som beviljats genom en delad installation. Åtkomsten är organisationsomfattande, inte begränsad till personen som installerade appen.

Alla repos vs utvalda repos

Alla repositories — Velumi ser alla nuvarande och framtida repos automatiskt. Enklaste alternativet för de flesta team.
Endast utvalda repositories — Velumi ser endast de repos du uttryckligen beviljar. Du behöver återvända till GitHub och bevilja åtkomst när du vill deploya ett nytt repo.

Oavsett vilket, Velumi läser endast din kod vid byggtillfället. Den kan inte pusha, skapa grenar, öppna issues eller modifiera dina repositories på något sätt.

Privata npm-paket från GitHub

Om ditt projekt är beroende av privata npm-paket som är hostade på GitHub (via GitHub Packages eller ett privat register som backas upp av GitHub), behöver Velumi en GitHub-appinstallation för varje GitHub-organisation som äger dessa paket — inte bara den org som äger källrepot.

Under en deploy skapar Velumi en ny åtkomsttoken för varje installation på din Velumi-org och gör dem tillgängliga för bygget så att npm install / pnpm install kan autentisera mot privata paket över flera orgs.

Exempel: Din projektkälla ligger i acme-corp/website, men package.json refererar till @design-system/tokens från ett privat paket som ägs av acme-design. Installera Velumi GitHub-appen på både acme-corp och acme-design.

Installation på ytterligare orgs görs på samma sätt — Organization → Integrations → Add Another Installation.

Efter installation

Tillbaka i Velumi listar Integrations-sidan dina installationer. Därifrån kan du:

Manage on GitHub — ändra omfattning, lägg till eller ta bort repos
Remove — koppla bort installationen från Velumi