Orbit Projectinstellingen

Elk onderdeel van een Orbit-project is te vinden op het tabblad Instellingen, ingedeeld zodat je alles gemakkelijk kunt vinden: algemene informatie, build en deploy, beveiliging, meldingen, integraties, gebruikslimieten, deploy-automatisering, netwerken, observeerbaarheid, delen en een gevarenzone onderaan.

Waar Instellingen zich bevinden

Open Orbit, klik op het project en kies Settings in het projecttabblad. De pagina beschrijft zichzelf als het configureren van je projectnaam, buildcommando's en Git-integratie, wat het aanzienlijk onderwaardeerd.

Deze gids is een kaart. Waar een onderwerp een eigen artikel heeft, wordt het gelinkt in plaats van herhaald.

Algemeen

Project info toont de URL-slug, de aanmaakdatum, de verbonden repository en de productie-URL, en stelt je in staat om de projectnaam (Name) en beschrijving (Description) te wijzigen.

Git bevat de Production branch. Pushes naar die branch triggeren productiedeployments.

Status badge geeft je een live deploy-status SVG met kopiërknoppen voor de URL, markdown en HTML, klaar om in je README te plakken. Zie Viewing Your Project README In Orbit.

Public status page linkt naar de configuratie van de statuspagina. Zie Orbit Status Page.

Build en Deploy

Build settings zijn de vijf velden die Orbit automatisch detecteert en die je kunt overschrijven: installcommando, buildcommando, uitvoermap, hoofdmap en Node.js-versie. Laat een veld leeg om de gedetecteerde waarde te behouden. Volledige details staan in Configuring Your Build Command and Output Directory.

Runtime bevat vier schakelaars die de moeite waard zijn om te begrijpen:

• Server mode houdt de buildmachine actief en voert je startcommando uit na elke deploy. Vereist voor alles wat aan de serverkant wordt weergegeven in plaats van statische bestanden te exporteren.
• Branch previews creëren automatisch een omgeving voor elke branchpush die niet productie of staging is, elk op zijn eigen URL onder branch-*.kaps.run. Zie Branch Previews.
• Auto-rollback on failure herstelt de laatste gezonde productiedeployment als een deploy mislukt.
• Scheduled rebuild herbouwt productie met een interval, van elk uur tot wekelijks, wat geschikt is voor contentgestuurde sites die een vernieuwing nodig hebben zonder een git push.

Build auto-retry plaatst builds opnieuw in de wachtrij die op infrastructuurfouten zoals een netwerkprobleem of timeout zijn mislukt, tot drie keer toe. Het probeert codefouten niet opnieuw, dus het kan een kapotte build niet verbergen.

Ignored paths en Branch ignore patterns voorkomen builds die je niet nodig hebt: globpatronen voor bestanden waarvan wijzigingen niet moeten worden gedeployed, en voor branches zoals dependabot/* die er nooit een moeten triggeren.

Git tag deploys stelt het tagpatroon in dat een tagpush in een productiedeployment omzet. Zie Orbit Releases.

Deploy-automatisering en -bescherming

Deploy protection heeft twee poorten: Require approval for production, wat door push geactiveerde productiedeployments opschort totdat iemand goedkeurt, en Require staging success before production, wat productie vasthoudt totdat staging dezelfde commit succesvol heeft gedeployed.

CI required checks beperk deployments aan je eigen CI. Op GitHub vermeld je jobnamen, die allemaal moeten slagen; op GitLab wacht elke niet-lege waarde op de volledige pijplijn. Een CI-fout annuleert de deploy.

Deploy freeze schedule blokkeert push-geactiveerde deployments buiten goedgekeurde vensters, ofwel weekends ofwel een UTC-uurrange. Handmatige deployments en deploy hooks worden niet beïnvloed.

Branch protection voegt globpatroonregels toe die deployments op overeenkomende branches blokkeren totdat vereiste externe controles slagen en optioneel een persoon goedkeurt.

Auto-promote staging bevordert staging automatisch naar productie zodra het voor een geconfigureerd aantal uren zonder gezondheidsstoringen is uitgevoerd en smoketests slagen.

Dit alles wordt samengevat in één weergave op het tabblad Orbit Deployment Pipeline.

Gezondheid en kwaliteitsgates

Health check haalt een pad op dat je kiest na elke productiedeployment. Een niet-2xx-respons binnen 15 seconden herstelt de vorige gezonde deployment.

Smoke tests voeren GET-verzoeken uit tegen maximaal tien door komma's gescheiden paden na elke geslaagde deploy en registreren slagen of mislukken. Gecombineerd met auto-rollback, rolt een mislukte smoketest de deploy terug.

Performance budgets waarschuwen of mislukken builds die een drempel overschrijden: totale artefactgrootte in MB, individuele bestandsgrootte in kB overeenkomend met een glob, of buildtijd in seconden. Elk budget is ingesteld op waarschuwing of falen van de build.

Staging

Staging krijgt zijn eigen set kaarten: de staging branch, access protection met een wachtwoord, een IP allowlist die IPv4-adressen en CIDR-ranges accepteert één per regel, auto-rollback on failure, of staging inherits production environment variables met lagere prioriteit, en build overrides voor installatie, build, uitvoer en hoofdmap.

Wachtwoord en IP-allowlist zijn de twee om in te stellen op elke stagingomgeving die niet openbaar bedoeld is. Laat beide leeg en de staging-URL is bereikbaar voor iedereen die deze heeft.

Netwerk

Custom domains voegt domeinen voor de productieomgeving toe en verifieert deze, inclusief certificaatinrichting. Zie Adding a Custom Domain to Orbit.

Redirects and rewrites zijn padgebaseerde regels die voor serving worden toegepast, getest in volgorde met eerste overeenkomst wint. Een omleiding stuurt de browser naar een nieuwe URL als 301 of 302; een herschrijving serveet een ander pad stilletjes zonder URL-wijziging. Patronen ondersteunen exacte overeenkomsten, wildcards, benoemde parameters en splats. Zie Redirects and Rewrites in Orbit.

Response headers passen aangepaste HTTP-headers toe op overeenkomende paden, met voorinstellingen voor HSTS, CSP, no-embed, no-sniff, referrerbeleid en CORS. Alle overeenkomende regels worden toegepast en latere items overschrijven eerdere voor dezelfde sleutel.

Skew protection bewaart oude bouwartefacten in opslag voor een retentievenster nadat een nieuwe implementatie live gaat, zodat een bezoeker die de vorige versie heeft geladen, nog steeds de activa ervan kan ophalen in plaats van een 404 te krijgen.

The config store bevat sleutel/waardeinstellingen die je implementatie tijdens runtime leest, voor functieflaggen en instellingen die veranderen zonder opnieuw te implementeren. Het wordt beheerd onder Storage, niet hier, en het is gratis: er is geen leeskosten en geen schrijfkosten. Waarden worden opgeslagen in platte tekst, dus plaats nooit een geheim in één. Tot 100 items per project, sleutels tot 200 tekens en waarden tot 4096. Elke nacht wordt een snapshot van elk item gemaakt en dertig nachten worden op elk plan bewaard, dus een item dat je verwijdert, kan worden teruggehaald: zie Snapshots and restore.

Gebruik en limieten

Build usage toont de builds die dit project heeft uitgevoerd.

Spending cap stelt de maximale maandelijkse overschrijdingsuitgave in, covering build-minuten en bandbreedteoverschrijdingen buiten de toewijzing van je plan. Het minimum is US$6.32 en het maximum US$6,315.79. Waarschuwingen verschijnen op 50% en 80%, en op 100% pauzeren het bedienen totdat je de limiet verhoogt. Zie Orbit Spending Cap.

Build spending cap is de aparte, stompere limiet: een maandelijks plafond voor totale buildminuten, waarna nieuwe builds niet meer in de wachtrij staan totdat volgende maand of je verhoogt het.

Artifact retention stelt in hoeveel geslaagde bouwartefacten per omgeving moeten worden bewaard. Oudere worden dagelijks verwijderd, en de momenteel live implementatie wordt altijd bewaard ongeacht de limiet.

Preview expiry pauzeer preview-omgevingen na 7, 14, 30 of 60 dagen, of nooit. Gepauzeerde previews hebben hun opslag teruggewonnen binnen 24 uur.

Artifact size alert stuurt je een e-mail wanneer een bouwartefact een door jou ingestelde grootte overschrijdt.

Meldingen, integraties en observeerbaarheid

Deploy email notifications heeft drie instellingen: alle deployments, alleen mislukkingen, of uit. Een notification webhook URL kan ernaast worden ingesteld, posting op elk succes of mislukking.

Notification channels is de rijkere versie, met selectie per gebeurtenis, afleveringsgeschiedenis en een testknop. Volledige webhookcontrole bevindt zich op zijn eigen tabblad: zie Orbit Webhooks.

Deploy hooks creëert geheime URL's die een deploy triggeren wanneer iets ernaartoe POSTs. Zie Triggering Deployments Via Deploy Hooks.

Log drains verscheepen bouwlogboeken naar je observeerbaarheidsplatform na elke implementatie, met ingebouwde ondersteuning voor Datadog, Logtail, Axiom en New Relic, of een aangepaste webhook, optioneel gefilterd op één omgeving.

Web Analytics geeft je het Core Web Vitals-verzamelingssnippet. Zie Orbit Web Vitals.

Cron triggers plant HTTP-verzoeken naar een gekozen omgeving in, tot tien per project. De grotere, alleen-productieversie bevindt zich op zijn eigen tabblad: zie Orbit Cron Jobs.

Delen en Team

Team beheert medewerkers met drie rollen: admin, developer en viewer.

Share links genereren tijdelijke wachtwoordloze links zodat een externe reviewer een omgeving kan bekijken zonder wachtwoord of account. Elke link kan vervallen in 1 uur, 24 uur of 7 dagen, of nooit, en toont het bezoekersaantal. Trek er op elk moment één in.

Deployment group voegt dit project toe aan een groep zodat gerelateerde projecten samen implementeren, optioneel gefilterd op branch.

Clone environment en Clone project dupliceren configuratie. Het klonen van een project kopieert buildinstellingen, omgevingsconfiguratie en niet-geheime omgevingsvariabelen; geheimen worden niet gekopieerd.

Gevarenzone

Clear build cache verwijdert de cached afhankelijkheden voor elke omgeving, zodat de volgende implementatie een volledige installatie from scratch uitvoert. Het kan niet ongedaan worden gemaakt, hoewel de cache zichzelf herbouwt bij de volgende build.

Transfer project verplaatst het project naar een ander Kapsule-account. Zie Transferring an Orbit Project.

Archive project stopt onmiddellijk met het serveren van verkeer. Het is herstelbaar binnen 30 dagen uit de Orbit-lijst, waarna het permanent wordt verwijderd.

Waar je vervolgens heen gaat

• Orbit Deployment Pipeline om het effect van elke instelling in één weergave te zien.
• Shared Environment Variable Groups voor waarden die in projecten worden gebruikt.
• Orbit Plan Limits voor wat je plan toestaat.