Esercizi progressivi

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

A un roll-out progressivo si mantiene un bundle stabile di un canale un bundle stabile un bundle di roll-out separato un target di roll-out un target di roll-out separato

Progressive rollout controls in a Capgo channel — un insieme di dispositivi controllato

un insieme di dispositivi controllato

un insieme di dispositivi controllato un insieme di dispositivi controllato
Rollout obiettivo --- il bundle candidato che viene rilasciato gradualmente.

Un rollout richiede un bundle stabile. Nel dashboard, assegna il bundle stabile prima di scegliere il target; con il Public API, un canale esistente può fornire version e rolloutVersion nello stesso richiesta POST. Capgo prende una decisione casuale per ogni dispositivo eleggibile, quindi la memorizza utilizzando una chiave di hash dell'ID dispositivo e dell'ID rollout. Ciò rende il cohort adesivo per la durata di cache configurata invece di cambiare con ogni controllo di aggiornamento.

Modifiche percentuali

Capgo mantiene le decisioni esistenti quando può:

Incrementare un percentuale --- dispositivi già selezionati rimangono selezionati; solo un sottoinsieme casuale di dispositivi precedentemente non selezionati viene aggiunto.
Riduci un percentuale --- un sottoinsieme casuale del cohort selezionato torna alla bundle stabile.
Imposta la percentuale a 0% --- non vengono selezionati nuovi dispositivi. I dispositivi già in esecuzione con il target di distribuzione abilitato continuano a riceverlo fino a quando non disabiliti, non torni indietro o non cambi il target.
Pausa --- ferma nuovi dispositivi dall'ingresso mentre i dispositivi già in esecuzione con il target abilitato rimangono su di esso.
Disabilita --- ferma la risoluzione del target di distribuzione; le verifiche di aggiornamento utilizzano la bundle stabile.

Esegui una distribuzione

Carica e assegna una bundle testata come bundle stabile del canale.
Carica il bundle candidato senza sostituire il bundle stabile.
Apre la scheda Scheda impostare il candidato come Destinazione, scegli un piccolo percentuale e abilita il rollout.
Monitora il rollout in Osserva, Log Insights, e la storia del canale. Incrementa il percentuale solo dopo che il cohort è sano.
Quando è pronto, promuovi il destinatario a stabile. Se non è sano, fermo o riprendilo.

CLI esempio

Lanciare un rollout per bundle 1.3.0 a 5%:

npx @capgo/cli@latest channel set production com.example.app \
  --rollout-bundle 1.3.0 \
  --rollout-percentage 5 \
  --rollout-enable

Incrementarlo senza riavviare i dispositivi già selezionati:

npx @capgo/cli@latest channel set production com.example.app \
  --rollout-percentage 25

La comando di caricamento del bundle può impostare l'upload come un target di rollout in un passo quando il canale ha già un bundle stabile:

npx @capgo/cli@latest bundle upload com.example.app \
  --path ./dist \
  --channel production \
  --rollout 5

Vedere il completo canale CLI di riferimento e pacchetto CLI di riferimento per ogni opzione di distribuzione.

Sospesa, annulla o promuovi

Azione	Cosa fa
Sospesa	Ferma nuovi dispositivi dall'ingresso nella distribuzione. I dispositivi già sul target abilitato rimangono lì.
Riprendi	Consente nuovi dispositivi idonei di rientrare nuovamente.
Disabilita	Sospende la risoluzione del target di distribuzione e utilizza il bundle stabile.
Ripristina	Cancella il target, disabilita la distribuzione, resetta il percentuale a 0% e restituisce i dispositivi allo stato stabile.
Promuovi	context: Pagina/Area: Sito web di marketing Capgo. Ruolo: Intestazione di sezione o pagina. Visualizzato in: pagina affiliate.astro. Messaggio chiave `affiliate_step2_title` (Titolo di Step2 Affiliato).

Fa del target di distribuzione il bundle stabile, poi cancella lo stato di distribuzione.

# Stop adding devices while you investigate
npx @capgo/cli@latest channel set production com.example.app --rollout-pause

# Make the candidate stable for everyone
npx @capgo/cli@latest channel set production com.example.app --rollout-promote

# Discard the candidate and return to stable
npx @capgo/cli@latest channel set production com.example.app --rollout-rollback

Copia negli appunti

Conserva il bundle di destinazione disponibile fino a quando non lo promuovi o lo ripristini. I bundle collegati come bundle stabile o target di distribuzione sono protetti dalla cancellazione.

Ecco come Capgo può valutare un rollout abilitato ogni cinque minuti e agire quando il segnale di fallimento supera il tuo livello di soglia. Misura gli installi e le fallite per il target del rollout nella selezionata canale e finestra di tempo, quindi utilizza un limite di confidenza di Wilson al posto della sola percentuale di fallimento.

L'auto-pausa è disabilitata di default. Configura questi campi nella scheda del canale o con Informazioni Limite di fallimento (in punti base ( channel set:

= 5%). È richiesto un limite per attivare la politica. Finestra500 in minuti (default: 60).
Confidenza tra
e context 0 Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: page trust.astro. Message key `and` (And). 1 Tempo di attesa 0.95).
Minimo di tentativi e fallimenti facoltativi, per evitare di agire su piccoli campioni.
Timeout in minuti (default: 60), che impedisce azioni ripetute.
azione: pause, rollback, o notify.

pause ferma la nuova esposizione del rollout, rollback svuota il target e torna allo stato stabile, e notify inviare un avviso di rollout senza modificare la consegna del rollout.

npx @capgo/cli@latest channel set production com.example.app \
  --auto-pause-enabled \
  --auto-pause-failure-rate-bps 500 \
  --auto-pause-window-minutes 60 \
  --auto-pause-confidence 0.95 \
  --auto-pause-min-attempts 100 \
  --auto-pause-min-failures 5 \
  --auto-pause-action pause \
  --auto-pause-cooldown-minutes 120

API e controlli della dashboard

Puoi gestire la stessa funzione attraverso il Canali pubblici API o il pannello di controllo:

Apre un'app, quindi Canali.
contexto: nome della funzione dei canali di rilascio di Capgo. Pagina/area: pagina di marketing delle soluzioni di Capgo. Ruolo: etichetta di navigazione breve o elemento di navigazione. Visto in: pagina soluzioni/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Valore della cella visiva del white label delle soluzioni).
Scegli il canale. Apre.
Informazioni Utilizza il Rilascio progressivo

For general routing and device precedence, see Canali. Per il ripristino di emergenza di un bundle fuori da un aggiornamento progressivo, vedi Ritornare a un aggiornamento live.