Esercizi progressivi

Una distribuzione progressiva mantiene il pacchetto stabile di un canale il pacchetto stabile in posizione mentre consegna un obiettivo di distribuzione separato obiettivo di distribuzione a un insieme di dispositivi controllato. È utile quando desideri una validazione di produzione reale senza passare al canale intero in una volta sola.

Configura l'obiettivo di distribuzione, il percentuale, la durata della cache e la politica di pausa automatica dalla scheda Informazioni del canale.

Come funzionano le distribuzioni progressive

Pacchetto stabile

• — il pacchetto normale assegnato al canale. Pacchetto stabile — il pacchetto normale assegnato al canale.
• 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 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 aderente 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. Cambiare 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 un sottogruppo casuale di dispositivi precedentemente non selezionati viene aggiunto.
• Riduci un percentuale --- un sottogruppo 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 il pannello Informazioni impostando il candidato come Destinazione, 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, frena o riprendilo.

CLI esempio

Avvia 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

Aumentalo senza riavviare i dispositivi già selezionati:

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

Il 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

Vedi 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	Elimina il target, disabilita la distribuzione, resetta il percentuale a 0% e restituisce i dispositivi allo stato stabile.
Promuovi	context

Page/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 dell'Affiliato).

# 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

Fenestra del terminale

Copia nella clipboard

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

La pausa automatica è disabilitata di default. Configura questi campi nella scheda Informazioni del canale o con channel set:

• Limite di fallimento ( = 5%). È richiesto un limite per attivare la politica.500 Finestra
• in minuti (di default: 60). Confidenza
• tra e 0 context: Pagina/Area: Sito web di marketing Capgo. Ruolo: Etichetta breve UI o elemento di navigazione. Visto in: pagina trust.astro. Chiave del messaggio `e` (E). 1 (default:) 0.95).
• Minimo di tentativi e fallimenti facoltativi, per evitare di agire su piccoli campioni.
• Cooldown in minuti (default: 60), che impedisce azioni ripetute.
• Azione: pause, rollback, o notify.

pause ferma l'esposizione alla nuova distribuzione, rollback cancella il target e torna allo stato stabile, e notify invia un avviso di distribuzione senza modificare la consegna della distribuzione.

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 del pannello di controllo

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

1. Apre un'app, quindi Canali.
2. contexto: nome della funzione dei canali di rilascio di Capgo. Pagina/area: pagina di marketing delle soluzioni di Capgo. Ruolo: etichetta breve di UI o elemento di navigazione. 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 Sezione di rilascio progressivo per scegliere il target, il percentuale, la durata della cache e la politica di pausa automatica.

For informazioni generali sulla routing del canale e sulla precedenza del dispositivo, vedere CanaliCloudflare . Per il recupero di pacchetti di emergenza fuori da un rollout progressivo, vedere.