INTEGRITY Dokumentace

← Cloudflare Workers / workers / wrangler / commands

Vlajková loď

Použijte wrangler flagship ke správě Vlajková loď aplikace a feature flags z příkazové řádky.

wrangler flagship je dostupná ve Wrangleru v4.107.0 a novějších.

Ověřování

Spustit wrangler login, nebo nastavte CLOUDFLARE_API_TOKEN na API token s oprávněními Flagship.

Oprávnění Vyžadováno pro
flagship:read Vypisování aplikací, kontrola flags, vyhodnocování flags a čtení changelogů.
flagship:write Vytváření, aktualizace, mazání, aktivace, deaktivace, rollout a rozdělování aplikací nebo příznaků.

Většina zápisových workflow před uložením aktualizované definice nejprve přečte aktuální flag, proto pro provozní použití udělte obě oprávnění.

ID aplikací

wrangler flagship flags příkazy vždy jako první argument očekávají ID aplikace. Většina podpříkazů pak přebírá klíč příznaku; příkazy typu výpis, jako například flags list, berou pouze app ID:

wrangler flagship flags get <APP_ID> new-checkout
wrangler flagship flags disable <APP_ID> new-checkout
wrangler flagship flags list <APP_ID>

Pokud ještě žádnou aplikaci nemáte, nejprve ji vytvořte:

wrangler flagship apps create checkout-service

Předejte --binding <NAME> při vytváření aplikace, abyste ji přidali do svého wrangler.json nebo wrangler.jsonc soubor jako binding Workeru.

Časté pracovní postupy

Vytvořte booleovský příznak. Bez variant Wrangler vytvoří on=true, off=false, a poskytuje off ve výchozím nastavení:

wrangler flagship flags create <APP_ID> new-checkout

Přidejte cílicí pravidla pomocí kompaktní syntaxe pravidel:

wrangler flagship flags create <APP_ID> premium-banner \
	-V on=true \
	-V off=false \
	--default off \
	--rule "serve=on; when=plan equals enterprise AND country in [US,CA]; rollout=25%@user_id"

Použijte velká písmena AND a OR mimo hodnoty v uvozovkách ke kombinování podmínek. Hodnoty obsahující vyhrazená slova nebo oddělovače uzavřete do uvozovek:

wrangler flagship flags create <APP_ID> banner-copy \
	-V shown=true \
	-V hidden=false \
	--default hidden \
	--rule 'serve=shown; when=title equals "WAR AND PEACE" OR country in ["US","CA"]'

U hluboce vnořených skupin podmínek použijte --rule-json. Wrangler před odesláním požadavků ověří jak kompaktní pravidla, tak pravidla JSON.

Změňte jedno existující pravidlo, aniž byste museli přepisovat celou sadu pravidel:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--rollout 50%@user_id

Vyhodnocení flagu pro uživatele:

wrangler flagship flags evaluate <APP_ID> premium-banner \
	--context plan=enterprise \
	--context country=US \
	--targeting-key user-42

Použijte disable jako okamžitý kill switch:

wrangler flagship flags disable <APP_ID> premium-banner

Více příznaků povolíte, zakážete nebo odstraníte zadáním ID aplikace následovaného více klíči:

wrangler flagship flags disable <APP_ID> new-checkout dark-mode premium-banner
wrangler flagship flags delete <APP_ID> coming-soon old-banner --force

Příkazy pro odstranění vyžadují --force při použití s --json aby prompty nemohly poškodit výstup JSON. rollout a split vyžadují totéž, pokud by nahrazovala existující pravidla cílení, která mají podmínky.

Viz Referenční přehled hlavních příkazů Wrangler pro kompletního průvodce pracovním postupem, který pokrývá cílicí pravidla, postupné nasazování, rozdělení provozu, changelogy a skriptování pomocí --json.

Příkazy

flagship apps create

Vytvořte aplikaci Flagship

npx wrangler flagship apps create [NAME]

Globální přepínače

flagship apps list

Vypsat aplikace Flagship

npx wrangler flagship apps list

Globální přepínače

flagship apps get

Získat aplikaci Flagship

npx wrangler flagship apps get [APP-ID]

Globální přepínače

flagship apps update

Aktualizovat aplikaci Flagship

npx wrangler flagship apps update [APP-ID]

Globální přepínače

flagship apps delete

Odstranit aplikaci Flagship

npx wrangler flagship apps delete [APP-ID]

Globální přepínače

flagship flags create

Vytvořte feature flag v aplikaci Flagship

npx wrangler flagship flags create [APP-ID] [KEY]

Globální přepínače

flagship flags list

Vypsat feature flags v aplikaci Flagship

npx wrangler flagship flags list [APP-ID]

Globální přepínače

flagship flags get

Získat feature flag z aplikace Flagship

npx wrangler flagship flags get [APP-ID] [KEY]

Globální přepínače

flagship flags update

Aktualizovat feature flag v aplikaci Flagship

npx wrangler flagship flags update [APP-ID] [KEY]

Globální přepínače

flagship flags set

Nastavit výchozí variantu poskytovanou feature flagem

npx wrangler flagship flags set [APP-ID] [KEY]

Globální přepínače

flagship flags rules list

Vypsat cílicí pravidla pro feature flag

npx wrangler flagship flags rules list [APP-ID] [KEY]

Globální přepínače

flagship flags rules update

Aktualizovat jedno cílicí pravidlo pro feature flag

npx wrangler flagship flags rules update [APP-ID] [KEY]

Globální přepínače

flagship flags rules delete

Odstranit jedno cílicí pravidlo z feature flagu

npx wrangler flagship flags rules delete [APP-ID] [KEY]

Globální přepínače

flagship flags rules reorder

Změnit pořadí cílicích pravidel pro feature flag

npx wrangler flagship flags rules reorder [APP-ID] [KEY]

Globální přepínače

flagship flags split

Rozdělte provoz mezi varianty podle procent

npx wrangler flagship flags split [APP-ID] [KEY]

Globální přepínače

flagship flags rollout

Nasaďte jednu variantu na procento provozu

npx wrangler flagship flags rollout [APP-ID] [KEY]

Globální přepínače

flagship flags enable

Povolení feature flagu

npx wrangler flagship flags enable [APP-ID] [KEY]

Globální přepínače

flagship flags disable

Zakázat feature flag

npx wrangler flagship flags disable [APP-ID] [KEY]

Globální přepínače

flagship flags evaluate

Vyhodnocení feature flagu s volitelným kontextem

npx wrangler flagship flags evaluate [APP-ID] [KEY]

Globální přepínače

flagship flags delete

Odstranit feature flag z aplikace Flagship

npx wrangler flagship flags delete [APP-ID] [KEY]

Globální přepínače

flagship flags changelog

Zobrazí changelog pro feature flag

npx wrangler flagship flags changelog [APP-ID] [KEY]

Globální přepínače