← Cloudflare Flagship / flagship / reference

Příkazy Wrangleru

Použijte wrangler flagship ke správě aplikací Flagship a příznaků funkcí z příkazové řádky. Každý wrangler flagship flags příkaz přijímá jako první argument ID aplikace. Většina podpříkazů pak přijímá klíč flagu, například wrangler flagship flags get <APP_ID> <KEY>. Příkazy typu seznam, jako například wrangler flagship flags list <APP_ID>, přijímají pouze ID aplikace.

wrangler flagship volá rozhraní Cloudflare API. Před spuštěním příkazů se přihlaste ve Wrangleru:

wrangler login

Pro automatizaci nastavte CLOUDFLARE_API_TOKEN na API token s příslušnými oprávněními Flagship.

Většina příkazů, které upravují existující flag, nejprve přečte aktuální flag a poté zapíše zpět aktualizovanou definici. Pro tyto postupy udělte obě flagship:read a flagship:write.

Přidejte do svého projektu Worker vazbu Flagship, aby mohl váš kód Workeru za běhu vyhodnocovat příznaky s nízkou latencí:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "flagship": [
    {
      "binding": "FLAGS",
      "app_id": "<APP_ID>"
    }
  ]
}

[[flagship]]
binding = "FLAGS"
app_id = "<APP_ID>"

Vytvoření booleovského příznaku, jeho vyhodnocení pro uživatele a jeho použití jako kill switch:

# With no variations, Wrangler creates on=true, off=false,
# and serves off by default.
wrangler flagship flags create <APP_ID> new-checkout

# Evaluate the flag for a user.
wrangler flagship flags evaluate <APP_ID> new-checkout --targeting-key user-42

# Disable the flag instantly. Disabled flags always serve their default variation.
wrangler flagship flags disable <APP_ID> new-checkout

Aplikace sdružují související příznaky. Běžným vzorem je jedna aplikace na službu, Worker nebo produktovou oblast.

wrangler flagship apps ls je alias pro apps list. wrangler flagship apps rm je alias pro apps delete.

wrangler flagship apps list automaticky prochází stránkování a zobrazí všechny aplikace v účtu.

Vytvoření aplikace vrátí ID aplikace a zobrazí úryvek vazby, který přidáte do konfigurace Wrangler:

wrangler flagship apps create checkout-service

Chcete-li přidat novou aplikaci do vašeho wrangler.json nebo wrangler.jsonc soubor jako binding Workeru, zadejte --binding:

wrangler flagship apps create checkout-service --binding FLAGS

Wrangler také podporuje --update-config k aktualizaci vaší konfigurace JSON nebo JSONC po vyzvání k zadání názvu vazby.

U konfiguračních souborů, které nejsou ve formátu JSON, Wrangler vypíše úryvek vazby, ale soubor automaticky neupraví.

Když --json se použije, apps create vypíše vytvořenou aplikaci jako JSON a nevyzývá k aktualizaci konfigurace ani ji neaktualizuje.

Ve skriptech získejte ID aplikace z výstupu JSON:

APP_ID=$(wrangler flagship apps create checkout-service --json | jq -r '.id')

Odstraněním aplikace se odstraní všechny její příznaky i historie změn. Pokud na aplikaci stále odkazuje Worker prostřednictvím Flagship bindingu, API odstranění aplikace odmítne.

Použijte --force nebo -y k přeskočení potvrzovací výzvy k odstranění. Pokud také použijete --json, musíte předat --force aby se potvrzovací výzva nemohla objevit ve výstupu JSON.

wrangler flagship apps delete <APP_ID> --force

Více aplikací odstraníte předáním více ID aplikací:

wrangler flagship apps delete <APP_ID_1> <APP_ID_2> <APP_ID_3> --force

Klíče příznaků jsou v rámci aplikace jedinečné. Používejte stabilní klíče, které popisují řízené chování, například new-checkout, pricing-page-layout, nebo upload-limit.

Pokud vynecháte varianty, Wrangler vytvoří boolean flag s on=true, off=false, a off jako výchozí variantu.

wrangler flagship flags create <APP_ID> new-checkout

Použijte --variation (-V) k přidání každé varianty jako name=value. Použijte --default k výběru záložní varianty.

# String flag.
wrangler flagship flags create <APP_ID> checkout-flow \
	-V v1=old-checkout \
	-V v2=new-checkout \
	--default v1 \
	--type string

# Number flag.
wrangler flagship flags create <APP_ID> upload-limit \
	-V free=10 \
	-V pro=100 \
	-V enterprise=1000 \
	--default free \
	--type number

# JSON flag.
wrangler flagship flags create <APP_ID> theme-config \
	-V 'light={"bg":"#ffffff","fg":"#111111"}' \
	-V 'dark={"bg":"#111111","fg":"#ffffff"}' \
	--default light \
	--type json

Podporované typy hodnot jsou boolean, string, number, a json. Pokud --type je vynechán, Wrangler u každé hodnoty samostatně odvodí její skalární typ.

Všechny varianty příznaku musí používat stejný typ hodnoty. Wrangler ještě před odesláním požadavku odmítne příznak, jehož varianty se vyhodnocují na různé typy, například jeden boolean a jedno number. Předejte --type explicitně, aby se každá varianta převedla na stejný typ.

Použijte --description (-d) k zdokumentování účelu příznaku:

wrangler flagship flags create <APP_ID> checkout-flow \
	-V v1=old-checkout \
	-V v2=new-checkout \
	--default v1 \
	--type string \
	--description "Controls which checkout experience is served"

Klíče příznaků a názvy variant mohou obsahovat písmena, číslice, spojovníky a podtržítka. Udržujte klíče stabilní, protože kód aplikace vyhodnocuje příznaky podle klíče.

Použijte --disabled k vytvoření příznaku, který zobrazuje svou výchozí variantu, dokud jej nezapnete.

wrangler flagship flags create <APP_ID> coming-soon \
	-V on=true \
	-V off=false \
	--default off \
	--disabled

Pravidla cílení určují, která varianta se má pro daný kontext vyhodnocení poskytnout. Předejte pravidla pomocí --rule nebo --rule-json.

Kompaktní --rule syntaxe používá segmenty oddělené středníkem:

serve=<VARIATION>; when=<CONDITIONS>; rollout=<PERCENT>%@<ATTRIBUTE>; priority=<NUMBER>

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"

Podmínky porovnávají atributy z vyhodnocovacího kontextu s hodnotami pravidla. Kompaktní syntaxe podporuje všechny Operátory Flagship:

--rule "serve=on; when=plan equals pro"
--rule "serve=on; when=country in [US,CA,UK]"
--rule "serve=off; when=email ends_with @example.com"
--rule "serve=strict; when=score less_than 20"

Použijte AND a OR ke kombinování podmínek. AND má vyšší prioritu než OR.

# Both conditions must match.
--rule "serve=on; when=plan equals pro AND country equals US"

# Either condition can match.
--rule "serve=on; when=plan equals enterprise OR plan equals team"

# Equivalent to: (plan=pro AND country=US) OR plan=enterprise.
--rule "serve=on; when=plan equals pro AND country equals US OR plan equals enterprise"

AND a OR jsou vyhrazeny jako logické operátory, pokud se vyskytnou mimo hodnoty v uvozovkách nebo mimo seznamy. Hodnoty obsahující vyhrazená slova nebo oddělovače obalte jednoduchými nebo dvojitými uvozovkami, například AND, OR, ;, nebo ,:

--rule 'serve=on; when=title equals "WAR AND PEACE" OR title equals "tom; jerry"'
--rule 'serve=on; when=country in ["US","CA"]'

Pro in a not_in, předejte seznam v hranatých závorkách. Wrangler ještě před odesláním požadavku odmítne neplatné seznamy, prázdné položky seznamu, neukončené uvozovky a nepárové závorky.

Použijte --rule-json pro hluboce zanořené logické skupiny nebo pokud chcete předat tvar pravidla API přímo. Wrangler ověří --rule-json oproti schématu pravidel Flagship a odmítne neznámá nebo konfliktní pole.

wrangler flagship flags create <APP_ID> beta-features \
	-V on=true \
	-V off=false \
	--default off \
	--rule-json '{"serve_variation":"on","conditions":[{"logical_operator":"OR","clauses":[{"attribute":"beta","operator":"equals","value":true},{"attribute":"plan","operator":"equals","value":"enterprise"}]}]}'

Opakujte --rule nebo --rule-json k deklaraci více pravidel. Pravidla se vyhodnocují v pořadí podle priority. Vyhrává první odpovídající pravidlo.

wrangler flagship flags create <APP_ID> rate-limit-tier \
	-V strict=50 \
	-V normal=200 \
	-V relaxed=1000 \
	--default normal \
	--type number \
	--rule "serve=strict; when=score less_than 20" \
	--rule "serve=relaxed; when=score greater_than_or_equals 90"

Wrangler ověřuje duplicitní priority pravidel, duplicitní názvy variant, chybně formátované seznamy, nekonečné číselné hodnoty jako Infinity, a neznámé názvy variant před odesláním požadavku.

Seznam flagů v aplikaci:

wrangler flagship flags list <APP_ID>

Příkaz pro výpis je stránkovaný. Použijte --limit a --cursor pro ruční stránkování, nebo --all k načtení všech stránek.

wrangler flagship flags list <APP_ID> --limit 50
wrangler flagship flags list <APP_ID> --cursor <CURSOR>
wrangler flagship flags list <APP_ID> --all

Zobrazení úplné definice flagu:

wrangler flagship flags get <APP_ID> new-checkout

wrangler flagship flags ls je alias pro flags list. wrangler flagship flags inspect je alias pro flags get.

wrangler flagship flags update načte aktuální příznak, použije vaše změny a zapíše celou definici příznaku zpět do API.

wrangler flagship flags update <APP_ID> new-checkout \
	--description "Redesigned checkout experience"

wrangler flagship flags update <APP_ID> upload-limit \
	--set-variation team=500

wrangler flagship flags update <APP_ID> upload-limit \
	--remove-variation team

Chcete-li přidat variantu k existujícímu flagu, nastavte nový název a hodnotu varianty:

wrangler flagship flags update <APP_ID> checkout-flow \
	--set-variation experiment=new-checkout-v2

Popis vymažete předáním prázdného řetězce:

wrangler flagship flags update <APP_ID> new-checkout --description ""

Když u existujícího flagu přidáváte nebo nahrazujete varianty, použijte --type pokud má Wrangler nové hodnoty převést na konkrétní typ:

wrangler flagship flags update <APP_ID> upload-limit \
	--type number \
	--set-variation team=500

Wrangler ověřuje, že výsledná sada variant má stále jediný typ hodnoty a že výchozí varianta i cílicí pravidla stále odkazují na známé varianty.

Příznak můžete také zapnout nebo vypnout prostřednictvím flags update, ačkoli flags enable a flags disable jsou kratší pro postupy typu kill switch:

wrangler flagship flags update <APP_ID> new-checkout --disable
wrangler flagship flags update <APP_ID> new-checkout --enable

wrangler flagship flags set <APP_ID> checkout-flow --variation v2

Použijte --clear-rules pokud se má nová výchozí hodnota zobrazovat všem.

wrangler flagship flags set <APP_ID> checkout-flow --variation v2 --clear-rules

Použijte --rule nebo --rule-json k nahrazení celé sady pravidel:

wrangler flagship flags update <APP_ID> premium-banner \
	--rule "serve=on; when=plan equals pro AND country not_in [CN,RU]"

Použijte --add-rule nebo --add-rule-json k připojení pravidel beze změny stávajících pravidel:

wrangler flagship flags update <APP_ID> premium-banner \
	--add-rule "serve=off; when=account_age less_than 7"

wrangler flagship flags update <APP_ID> premium-banner \
	--add-rule-json '{"serve_variation":"off","conditions":[{"attribute":"country","operator":"in","value":["CN","RU"]}]}'

Vymazání všech pravidel:

wrangler flagship flags update <APP_ID> premium-banner --clear-rules

Použijte rules list k zobrazení priorit, na které můžete cílit pomocí příkazů specifických pro pravidla:

wrangler flagship flags rules list <APP_ID> premium-banner

Flagship vyhodnocuje pravidla podle vzestupného priority; vítězí první odpovídající pravidlo. Použijte rules reorder k přeuspořádání stávajících pravidel bez nutnosti přepisovat každou podmínku.

Předejte stávající priority v novém pořadí. Wrangler je přečísluje na 1..n v tomto pořadí:

wrangler flagship flags rules reorder <APP_ID> rate-limit-tier --order 2,1

Pokud byly stávající priority 1=strict a 2=relaxed, díky tomu je relaxed prioritou 1 a strict prioritou 2.

Použijte rules update k úpravě jednoho pravidla podle priority při zachování zbytku sady pravidel.

Změna pouze procenta rolloutu:

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

Změna varianty, kterou pravidlo vrací:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--serve off

Změna podmínek pravidla:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--when "plan equals enterprise OR plan equals team"

Odeberte z pravidla podmínky, aby odpovídalo každému kontextu vyhodnocení:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--clear-conditions

Odeberte rollout z pravidla:

wrangler flagship flags rules update <APP_ID> premium-banner \
	--priority 1 \
	--clear-rollout

Použijte rules delete k odstranění jednoho pravidla podle priority:

wrangler flagship flags rules delete <APP_ID> premium-banner --priority 2

Po odstranění pravidla Wrangler přečísluje zbývající pravidla, aby priority zůstaly souvislé.

Vypnutí příznaku funguje jako okamžitý vypínač: vypnutý příznak ignoruje cílicí pravidla a vrací svou výchozí variantu.

wrangler flagship flags disable <APP_ID> new-checkout
wrangler flagship flags enable <APP_ID> new-checkout

Více příznaků v aplikaci zapnete nebo vypnete předáním ID aplikace a následně více klíčů:

wrangler flagship flags disable <APP_ID> new-checkout dark-mode premium-banner
wrangler flagship flags enable <APP_ID> new-checkout dark-mode premium-banner

Použijte rollout k zobrazení jedné varianty určitému procentu provozu.

wrangler flagship flags rollout <APP_ID> new-checkout \
	--to on \
	--percentage 25 \
	--by user_id

Použijte --from-variation (alias --from) k výběru záložní varianty pro zbývající provoz. Procento postupného zavádění 0 odstraní pravidlo postupného zavádění a ponechá aktuální výchozí variantu příznaku beze změny.

rollout odešle vámi zadané procento přímo do Flagship. Například --percentage 25 --to on zobrazí on variantu 25 % provozu rozřazeného do skupin. Zbývající provoz propadá do výchozí varianty příznaku.

Použijte split pro A/B testy nebo rozdělení provozu mezi více variant. Wrangler převede váhy na kumulativní prahové hodnoty rolloutu.

wrangler flagship flags split <APP_ID> checkout-flow \
	--weight v1=80 \
	--weight v2=20 \
	--by user_id

-w je alias pro --weight. Každou variantu lze ohodnotit vahou pouze jednou a váhy musí být konečná nezáporná čísla.

Váhy jsou relativní. Wrangler všechny váhy sečte, každou převede na procento z celkového součtu a do Flagship odešle kumulativní prahové hodnoty. Například --weight v1=80 --weight v2=20 odešle dvě vygenerovaná pravidla: jedno pro v1 s procentem postupného zavádění 80, a jedno pro v2 s procentem postupného zavádění 100. Tím se vytvoří rozsahy bucketů o velikosti 0-80 pro v1 a 80-100 pro v2.

Se třemi váhami, --weight a=50 --weight b=30 --weight c=20 se změní na kumulativní prahové hodnoty 50, 80, a 100. Varianty s nulovou vahou se přeskakují.

Použijte --default hodnotou split k výběru záložní varianty, pokud rozřazování do skupin nelze provést:

wrangler flagship flags split <APP_ID> checkout-flow \
	--weight v1=80 \
	--weight v2=20 \
	--default v1 \
	--by user_id

wrangler flagship flags rollout <APP_ID> new-checkout --to on --percentage 100 --force

Vyhodnoťte příznak z CLI a ověřte, co obdrží konkrétní kontext.

wrangler flagship flags evaluate <APP_ID> new-checkout

wrangler flagship flags evaluate <APP_ID> new-checkout \
	--targeting-key user-42

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

Použijte --targeting-key pro stabilní bucketing procentuálního rolloutu. Každý atribut kontextu předejte s --context name=value. wrangler flagship flags eval je alias pro flags evaluate.

--context lze opakovat. --ctx a -C jsou aliasy:

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

Hodnoty kontextu se na vyhodnocovací endpoint odesílají jako řetězce. Používejte stejné názvy atributů, jaké očekávají vaše cílicí pravidla.

Výstup vyhodnocení obsahuje:

Flagship zaznamenává události vytvoření, aktualizace a odstranění pro každý flag. Historii changelogu zobrazíte od nejnovějších:

wrangler flagship flags changelog <APP_ID> new-checkout

U dlouhých historií použijte ovládací prvky stránkování:

wrangler flagship flags changelog <APP_ID> new-checkout --limit 10
wrangler flagship flags changelog <APP_ID> new-checkout --cursor <CURSOR>
wrangler flagship flags changelog <APP_ID> new-checkout --all

wrangler flagship flags history je alias pro flags changelog.

wrangler flagship flags delete <APP_ID> coming-soon

Použijte --force nebo -y k přeskočení potvrzovací výzvy. Pokud také použijete --json, musíte předat --force aby se potvrzovací výzva nemohla objevit ve výstupu JSON.

wrangler flagship flags delete <APP_ID> coming-soon --force

wrangler flagship flags rm je alias pro flags delete.

Více příznaků odstraníte předáním ID aplikace a následně více klíčů:

wrangler flagship flags delete <APP_ID> coming-soon old-checkout temporary-banner --force

Každý wrangler flagship příkaz přijímá --json. Výstup JSON potlačuje banner Wrangleru a je určen pro skripty.

Příkazy pro odstranění vyžadují --force hodnotou --json aby stdout zůstal platným JSON. rollout a split také vyžadují --force hodnotou --json pokud by nahradily existující cílicí pravidla, která mají podmínky.

Hromadné příkazy, například flags delete, flags enable, a flags disable, pokračujte ve zpracování zbývajících příznaků, pokud se jeden příznak nezdaří. V režimu JSON vracejí částečná selhání chybový objekt JSON obsahující úspěšné results a pro jednotlivé flagy failures.

Příkazy, které mohou aktualizovat wrangler.json nebo wrangler.jsonc, jako je apps create --binding, nezobrazujte výzvu ani neaktualizujte konfiguraci, pokud --json se používá.

Vytvoření aplikace, zaznamenání jejího ID a následné vytvoření příznaku:

APP_ID=$(wrangler flagship apps create checkout-service --json | jq -r '.id')

wrangler flagship flags create "$APP_ID" new-checkout --json

Více aplikací odstraníte ve smyčce:

for app_id in <APP_ID_1> <APP_ID_2> <APP_ID_3>; do
	wrangler flagship apps delete "$app_id" --force
done

Nebo předejte ID aplikací přímo:

wrangler flagship apps delete <APP_ID_1> <APP_ID_2> <APP_ID_3> --force

Následující reference je generována z Wrangleru flagship definice příkazů.

flagship apps create

Vytvořte aplikaci Flagship

npx wrangler flagship apps create [NAME]

• [NAME]string povinné

  Název aplikace

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

• --use-remoteboolean

  Při přidávání nově vytvořeného prostředku do konfigurace použijte remote binding

• --update-configboolean

  Automaticky aktualizovat konfigurační soubor o nově přidaný prostředek

• --bindingstring

  Název vazby (binding) tohoto prostředku ve vašem Workeru

flagship apps list

Vypsat aplikace Flagship

npx wrangler flagship apps list

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship apps get

Získat aplikaci Flagship

npx wrangler flagship apps get [APP-ID]

• [APP-ID]string povinné

  ID aplikace

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship apps update

Aktualizovat aplikaci Flagship

npx wrangler flagship apps update [APP-ID]

• [APP-ID]string povinné

  ID aplikace

• --namestring povinné

  Nový název aplikace

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship apps delete

Odstranit aplikaci Flagship

npx wrangler flagship apps delete [APP-ID]

• [APP-ID]string povinné

  Jedno nebo více ID aplikací ke smazání

• --forceboolean alias: --yvýchozí: false

  Přeskočit výzvu k potvrzení

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags create

Vytvořte feature flag v aplikaci Flagship

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --variationstring alias: --V

  Varianta flagu ve tvaru "name=value" (lze opakovat)

• --default-variationstring alias: --default

  Název varianty, která se má standardně zobrazovat (u booleovských příznaků je výchozí hodnota off, jinak první varianta)

• --typestring alias: --t

  Typ hodnoty varianty (odvozený, pokud není uveden)

• --descriptionstring alias: --d

  Popis flagu

• --disabledboolean výchozí: false

  Vytvoření příznaku v deaktivovaném stavu

• --rulestring

  Cílicí pravidlo, například "serve=on; when=plan equals pro AND region in [US,CA]; rollout=30%@user_id". Podmínky podporují AND/OR, priorita je volitelná a jako výchozí se použije pořadí deklarace (opakovatelné)

• --rule-jsonstring

  Cílicí pravidlo jako objekt JSON (opakovatelné)

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags list

Vypsat feature flags v aplikaci Flagship

npx wrangler flagship flags list [APP-ID]

• [APP-ID]string povinné

  ID aplikace

• --limitnumber

  Maximální počet vrácených příznaků (1-200)

• --cursorstring

  Kurzor stránkování z předchozího volání list

• --allboolean výchozí: false

  Načtěte všechny příznaky, stránkování proběhne automaticky

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags get

Získat feature flag z aplikace Flagship

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags update

Aktualizovat feature flag v aplikaci Flagship

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --enableboolean

  Povolit tento příznak

• --disableboolean

  Zakázat příznak

• --descriptionstring alias: --d

  Nový popis příznaku (chcete-li ho vymazat, zadejte "")

• --default-variationstring alias: --default

  Název varianty, která se má standardně zobrazovat

• --typestring alias: --t

  Typ hodnoty použitý k převodu hodnot --set-variation

• --set-variationstring

  Přidejte nebo nahraďte variantu ve formátu "name=value"

• --remove-variationstring

  Odebrat variantu podle názvu

• --rulestring

  Nahraďte cílicí pravidla flagu (opakovatelné)

• --rule-jsonstring

  Nahraďte cílicí pravidla příznaku pomocí JSON (opakovatelné)

• --add-rulestring

  Přidá cílicí pravidlo a zachová existující pravidla (opakovatelné)

• --add-rule-jsonstring

  Přidá cílicí pravidlo pomocí JSON a zachová existující pravidla (opakovatelné)

• --clear-rulesboolean výchozí: false

  Odebrat všechna cílicí pravidla

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags set

Nastavit výchozí variantu poskytovanou feature flagem

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --variationstring aliasy: --variant, --Vpovinné

  Varianta, která se má poskytovat ve výchozím nastavení

• --clear-rulesboolean výchozí: false

  Vymažte cílicí pravidla, aby se tato varianta zobrazovala vždy

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags rules list

Vypsat cílicí pravidla pro feature flag

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags rules update

Aktualizovat jedno cílicí pravidlo pro feature flag

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --prioritynumber povinné

  Priorita pravidla, které se má aktualizovat

• --servestring

  Varianta, která se má poskytovat, když toto pravidlo odpovídá

• --whenstring

  Podmínky pravidla se stejnou syntaxí jako --rule when=...

• --clear-conditionsboolean výchozí: false

  Odebrat podmínky, aby pravidlo odpovídalo všem kontextům

• --rolloutstring

  Rollout ve tvaru "percentage" nebo "percentage%@attribute"

• --clear-rolloutboolean výchozí: false

  Odebrat nasazení z tohoto pravidla

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags rules delete

Odstranit jedno cílicí pravidlo z feature flagu

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --prioritynumber povinné

  Priorita pravidla, které se má odstranit

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags rules reorder

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

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --orderstring povinné

  Existující priority pravidel oddělené čárkami v novém pořadí, například 2,1,3

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags split

Rozdělte provoz mezi varianty podle procent

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --weightstring alias: --w

  Váha varianty ve formátu "variation=weight" (opakovatelné)

• --bystring

  Atribut kontextu použitý pro sticky bucketing

• --default-variationstring alias: --default

  Záložní varianta, když nelze provést bucketing

• --forceboolean alias: --yvýchozí: false

  Přeskočit výzvu k potvrzení, když tento split nahradí existující pravidla cílení

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags rollout

Nasaďte jednu variantu na procento provozu

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --tostring povinné

  Varianta k nasazení

• --percentagenumber povinné

  Procento provozu, které se má obsloužit variantou nasazení (0-100)

• --bystring

  Atribut kontextu použitý pro sticky bucketing

• --from-variationstring alias: --from

  Záložní varianta pro zbývající provoz

• --forceboolean alias: --yvýchozí: false

  Přeskočit výzvu k potvrzení, když tento rollout nahradí existující pravidla cílení

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags enable

Povolení feature flagu

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Jeden nebo více klíčů příznaků k povolení

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags disable

Zakázat feature flag

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Jeden nebo více klíčů příznaků k zakázání

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags evaluate

Vyhodnocení feature flagu s volitelným kontextem

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --contextstring aliasy: --ctx, --C

  Kontext vyhodnocení ve formátu "name=value" (lze opakovat)

• --targeting-keystring

  Stabilní klíč bucketingu pro procentuální rollouty

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags delete

Odstranit feature flag z aplikace Flagship

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Jeden nebo více klíčů příznaků ke smazání

• --forceboolean alias: --yvýchozí: false

  Přeskočit výzvu k potvrzení

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON

flagship flags changelog

Zobrazí changelog pro feature flag

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

• [APP-ID]string povinné

  ID aplikace

• [KEY]string povinné

  Klíč příznaku

• --limitnumber

  Maximální počet vrácených záznamů (1-200)

• --cursorstring

  Kurzor stránkování z předchozího volání changelogu

• --allboolean výchozí: false

  Načtěte všechny záznamy, stránkování proběhne automaticky

• --jsonboolean výchozí: false

  Vracení výstupu jako JSON