Esercizi progressivi

A un rilascio progressivo si mantiene in posizione il bundle stabile di un canale, mentre si distribuisce un target di rilascio separato a un insieme di dispositivi controllato. il bundle stabile un target di rilascio separato ad un insieme di dispositivi controllato. È utile quando desideri una validazione di produzione reale senza passare al canale intero in una volta sola.

Configura il target di rilascio, il percentuale, la durata della cache e la politica di pausa automatica dalla scheda Informazioni del canale.

Come funzionano i rilasci progressivi

Bundle stabile

• – il bundle normale assegnato al canale. Stable bundle
• Target di distribuzione --- 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 pubblico API, un canale esistente può fornire version e rolloutVersion nello stesso richiesta POST. Capgo fa una scelta casuale per ogni dispositivo idoneo, quindi lo memorizza utilizzando una chiave di hash dell'ID dispositivo e dell'ID rollout. Ciò rende il cohort adesivo per la configurata durata di cache anziché cambiare con ogni controllo di aggiornamento.

Non significa permanente

La durata di cache predefinita per la decisione di rollout è di 30 giorni. Dopo che è scaduta, un dispositivo può essere selezionato nuovamente. Cambiando il target di rollout crea un nuovo ID di rollout e inizia un nuovo cohort. È possibile impostare la durata di cache da 60 secondi a 365 giorni.

Modifiche percentuali

Capgo preserva le decisioni esistenti quando può:

• Incrementare un percentuale — i dispositivi già selezionati rimangono selezionati; solo una sottoselezione casuale dei dispositivi precedentemente non selezionati viene aggiunta.
• Riduci un percentuale — una sottoselezione casuale del cohort selezionato torna al 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 il bundle stabile.

Esegui una distribuzione

1. Carica e assegna un bundle testato come bundle stabile del canale.
2. Carica il bundle candidato senza sostituire il bundle stabile.
3. Apre la scheda Informazioni impostare il candidato come Destinatario, scegli un piccolo percentuale e abilita il rollout.
4. Monitora il rollout in Osserva, Log Insights, e la storia del canale. Incrementa il percentuale solo dopo che il cohort è sano.
5. 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 obiettivo 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.

Sospendi, annulla o promuovi

Azione	Cosa fa
Sospendi	Ferma nuovi dispositivi dall'ingresso nella distribuzione. I dispositivi già sul target abilitato rimangono lì.
Ripristina	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. Chiave di messaggio `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.

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 Wilson confidence lower bound al posto della sola percentuale di fallimento.

Auto-pausa è disabilitata per impostazione predefinita. 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 (predefinito: 60).
• Confidenza tra
• e e 0 e 1 Tempo di attesa 0.95).
• Minimo di tentativi e fallimenti, per evitare di agire su piccoli campioni.
• Timeout in minuti (default: 60), che prevene azioni ripetute.
• Operazione: pause, rollback, o notify.

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

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 la dashboard:

1. Apre una app, poi Canali.
2. contexto: nome della funzione dei canali di rilascio di Capgo. Pagina/area: pagina di marketing delle soluzioni di Capgo. Ruolo: breve etichetta di navigazione o elemento UI. Visto in: pagina solutions/white-label.astro. Chiave di messaggio `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value).
3. Scegli il canale. Apre.
4. Informazioni Utilizza il Rilascio progressivo sezione per scegliere il target, il percentuale, la durata della cache e la politica di pausa automatica.

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