CLI
Rudel registruoja savo komandas skiltyje wp rudel. WP-CLI atmeta čia nenurodytą komandos parinktį su unknown --<name> parameter.
Įterptajam naudojimui galite pervadinti pagrindinę komandą, apibrėžę RUDEL_CLI_COMMAND faile wp-config.php prieš įkeliant papildinį.
define( 'RUDEL_CLI_COMMAND', 'sandbox' );
Tai pakeičia wp rudel create į wp sandbox create. Komandos veikimas nesikeičia.
Pagal numatytuosius nustatymus komandos vykdomos pagrindinėje aplinkoje. Norėdami vykdyti bet kurią kitą WP-CLI komandą smėlio dėžėje, nustatykite RUDEL_ENVIRONMENT:
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname
create
wp rudel create [--name=<name>] [--theme=<slug>] [--clone-from=<id>] [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--git=<remote>] [--type=<theme|plugin>] [--template=<label>]
Sukuria smėlio dėžę ir išveda jos ID.
| Parinktis | Reikšmė |
|---|---|
--name |
Žmogui suprantamas pavadinimas. ID sudaro pavadinimas ir keturi šešioliktainiai simboliai. Pagal numatytuosius nustatymus naudojamas saugyklos pavadinimas su --git, kitu atveju sandbox. |
--theme |
Į smėlio dėžę kopijuojama tema. Ji turi būti įdiegta pagrindinėje aplinkoje. Pagal numatytuosius nustatymus naudojama aktyvi pagrindinės aplinkos tema arba šaltinio smėlio dėžės tema su --clone-from. |
--clone-from |
Klonuoti lenteles ir temą iš esamos smėlio dėžės, o ne iš pagrindinės aplinkos. |
--owner, --labels, --purpose |
Metaduomenys. Žymos atskiriamos kableliais. |
--protected |
Neįtraukti smėlio dėžės į valymą. |
--ttl-days |
Galiojimo laikas nuo sukūrimo momento. |
--expires-at |
Aiškiai nurodytas galiojimo laiko žymos momentas. |
--git |
Klonuoti nuotolinę saugyklą į smėlio dėžės katalogą. Žr. Git. |
--type |
Kur --git išsaugo darbinę kopiją: theme (numatytoji reikšmė) arba plugin. |
--template |
Įraše saugoma žyma; numatytoji reikšmė blank. Išsaugotas šablonas neįkeliamas. |
--clone-db, --clone-themes, --clone-plugins, --clone-uploads, --clone-all, --shared-plugins ir --shared-uploads yra pasenusios. Jos keičia tik eigos pranešimus: kiekviena smėlio dėžė klonuoja lenteles, kopijuoja vieną temą ir bendrina papildinius bei įkeltus failus.
Komanda baigiama raginimu pereiti į smėlio dėžės katalogą cd ir paleisti wp post list. Tai vykdoma pagrindinėje aplinkoje, nes smėlio dėžės kataloge esantis wp-cli.yml nurodo pagrindinės aplinkos URL. Vietoj to naudokite RUDEL_ENVIRONMENT.
list
wp rudel list [--format=<table|json|csv|yaml|count>]
Išvardija smėlio dėžes ir pateikia jų ID, pavadinimą, savininką, apsaugą, galiojimo pabaigą, būseną, šablono žymą, sukūrimo laiką ir katalogo dydį.
info
wp rudel info <id> [--format=<table|json|yaml>]
Rodo vienos smėlio dėžės įrašą, įskaitant lentelių prefiksą, temą, žymas, klonavimo metaduomenis, URL ir turinio kelią.
update
wp rudel update <id> [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--unprotected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--clear-expiry]
Atnaujina metaduomenis. --ttl-days skaičiuoja laiką nuo dabar. Smėlio dėžės svetainės turinys nekeičiamas.
destroy
wp rudel destroy <id> [--force]
Pašalina smėlio dėžės lenteles, jos katalogą ir susietus darbinius medžius bei ištrina įrašą. Komanda prašo patvirtinti; --force praleidžia šį raginimą. Apsauga netrukdo vykdyti destroy: apsaugota smėlio dėžė sunaikinama kaip ir bet kuri kita.
status
wp rudel status
Išveda lentelę su įkrovos būsena, dabartine smėlio dėže, smėlio dėžių katalogu ir skaičiumi, rudel_config reikšmėmis bei informacija, ar automatizavimas suplanuotas. Visada išveda lentelę ir nepaiso --format.
cleanup
wp rudel cleanup [--dry-run] [--max-age-days=<days>] [--max-idle-days=<days>] [--merged]
Be --merged pašalina neapsaugotas smėlio dėžes, kurių galiojimo laikas baigėsi arba kurios viršija amžiaus ribą ar per ilgai neveikia. --max-age-days ir --max-idle-days šiam vykdymui pakeičia rudel_config. Naudojant --merged, pašalinamos smėlio dėžės, kurių susietos Git darbinio medžio šakos yra sujungtos. Apsaugotos smėlio dėžės visada praleidžiamos. Žr. Valymas.
logs
wp rudel logs <id> [--lines=<lines>] [--follow] [--clear]
Išveda paskutines smėlio dėžės debug.log eilutes (numatytoji reikšmė 50). --follow vykdo tail -f; --clear ištuština failą. Žr. Klaidų žurnalai.
snapshot
wp rudel snapshot <id> --name=<name>
Sukuria pavadintą momentinę kopiją.
restore
wp rudel restore <id> --snapshot=<name> [--force]
Atkuria momentinę kopiją. Komanda prašo patvirtinti; --force praleidžia šį raginimą. Žr. Momentinės kopijos.
template
wp rudel template save <id> --name=<name> [--description=<description>]
wp rudel template list [--format=<table|json|csv|yaml|count>]
wp rudel template delete <name> [--force]
Išsaugo, išvardija ir ištrina šablonų kopijas. Jokia komanda nesukuria smėlio dėžės iš išsaugoto šablono. Žr. Šablonai.
push
wp rudel push <id> [--git=<remote>] [--dir=<dir>] [--message=<message>]
Įrašo pakeitimus ir išsiunčia smėlio dėžės kataloge esančią darbinę kopiją į šaką rudel/<id>.
| Parinktis | Reikšmė |
|---|---|
--git |
Nuotolinė URL. Reikalinga tik tada, kai niekas neišsaugota; įsimenama po pirmo sėkmingo išsiuntimo. |
--dir |
Katalogas smėlio dėžės katalogo atžvilgiu, pavyzdžiui, themes/my-theme. Pagal numatytuosius nustatymus naudojamas išsaugotas darbinės kopijos katalogas, kitu atveju visas smėlio dėžės katalogas. |
--message |
Įrašo pranešimas; numatytoji reikšmė Update from Rudel sandbox. |
Žr. Git.