CLI
Rudel registrira svoje ukaze pod wp rudel. WP-CLI zavrne možnost, ki ni navedena za ukaz, z napako unknown --<name> parameter.
Za vdelano uporabo lahko preimenujete korenski ukaz tako, da določite RUDEL_CLI_COMMAND v wp-config.php, preden se vtičnik naloži.
define( 'RUDEL_CLI_COMMAND', 'sandbox' );
S tem se wp rudel create spremeni v wp sandbox create. Delovanje ukaza ostane nespremenjeno.
Ukazi so privzeto usmerjeni na gostitelja. Če želite kateri koli drug ukaz WP-CLI izvesti znotraj peskovnika, nastavite 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>]
Ustvari peskovnik in izpiše njegov ID.
| Možnost | Pomen |
|---|---|
--name |
Človeku berljivo ime. ID je sestavljen iz imena in štirih šestnajstiških znakov. Privzeta vrednost je ime repozitorija z --git, sicer sandbox. |
--theme |
Tema za kopiranje v peskovnik. Nameščena mora biti na gostitelju. Privzeto je to aktivna tema gostitelja ali tema izvornega peskovnika z --clone-from. |
--clone-from |
Namesto gostitelja klonira tabele in temo iz obstoječega peskovnika. |
--owner, --labels, --purpose |
Metapodatki. Oznake so ločene z vejicami. |
--protected |
Izvzame peskovnik iz čiščenja. |
--ttl-days |
Čas poteka glede na čas ustvarjanja. |
--expires-at |
Izrecen časovni žig poteka. |
--git |
Klonira oddaljeni repozitorij v imenik peskovnika. Glejte Git. |
--type |
Mesto, kamor --git izvede odjavo: theme (privzeto) ali plugin. |
--template |
Oznaka, shranjena v zapisu; privzeto blank. Shranjene predloge ne naloži. |
--clone-db, --clone-themes, --clone-plugins, --clone-uploads, --clone-all, --shared-plugins in --shared-uploads so zastareli. Spreminjajo samo sporočila o poteku: vsako peskovno okolje klonira tabele, kopira eno temo ter uporablja skupne vtičnike in naložene datoteke.
Ukaz se konča z namigom, naj v imenik peskovnega okolja prenesete cd in zaženete wp post list. To se izvede na gostitelju, ker wp-cli.yml v imeniku peskovnega okolja kaže na gostiteljski URL. Namesto tega uporabite RUDEL_ENVIRONMENT.
seznam
wp rudel list [--format=<table|json|csv|yaml|count>]
Izpiše peskovna okolja z ID-jem, imenom, lastnikom, zaščito, potekom veljavnosti, stanjem, oznako predloge, časom ustvarjanja in velikostjo imenika.
info
wp rudel info <id> [--format=<table|json|yaml>]
Prikaže zapis enega peskovnega okolja, vključno s predpono tabel, temo, oznakami, metapodatki klona, URL in potjo do vsebine.
posodobitev
wp rudel update <id> [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--unprotected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--clear-expiry]
Posodobi metapodatke. --ttl-days šteje od zdaj naprej. Vsebine mesta v peskovnem okolju ne spremeni.
uničenje
wp rudel destroy <id> [--force]
Odstrani tabele peskovnega okolja in njegov imenik ter povezane delovne kopije, nato pa izbriše njegov zapis. Ukaz zahteva potrditev; --force preskoči poziv. Zaščita ne prepreči destroy: zaščiteno peskovno okolje se uniči enako kot katero koli drugo.
stanje
wp rudel status
Izpiše tabelo s stanjem zagona, trenutnim peskovnim okoljem, imenikom peskovnih okolij, njihovim številom, vrednostmi rudel_config in podatkom, ali je avtomatizacija načrtovana. Vedno izpiše tabelo in prezre --format.
čiščenje
wp rudel cleanup [--dry-run] [--max-age-days=<days>] [--max-idle-days=<days>] [--merged]
Brez možnosti --merged odstrani nezaščitena peskovna okolja, ki jim je potekla veljavnost, so starejša od starostne omejitve ali so nedejavna dlje od omejitve nedejavnosti. Možnosti --max-age-days in --max-idle-days za ta zagon preglasita rudel_config. Z možnostjo --merged odstrani peskovna okolja, katerih povezane veje delovnih kopij Git so združene. Zaščitena peskovna okolja vedno preskoči. Glejte Čiščenje.
dnevniki
wp rudel logs <id> [--lines=<lines>] [--follow] [--clear]
Izpiše zadnje vrstice dnevniške datoteke peskovnega okolja debug.log (privzeto 50). --follow zažene tail -f; --clear izprazni datoteko. Glejte Beleženje napak.
posnetek
wp rudel snapshot <id> --name=<name>
Ustvari poimenovan posnetek.
obnovitev
wp rudel restore <id> --snapshot=<name> [--force]
Obnovi posnetek. Ukaz zahteva potrditev; --force preskoči poziv. Glejte Posnetki.
predloga
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]
Shrani, izpiše in izbriše kopije predlog. Noben ukaz ne ustvari peskovnega okolja iz shranjene predloge. Glejte Predloge.
potisni
wp rudel push <id> [--git=<remote>] [--dir=<dir>] [--message=<message>]
Potrdi spremembe in potisne kopijo za delo v imeniku peskovnega okolja v vejo rudel/<id>.
| Možnost | Pomen |
|---|---|
--git |
Oddaljeni URL. Potreben samo, če ni shranjen; po prvem uspešnem potisku si ga ukaz zapomni. |
--dir |
Imenik glede na imenik peskovnega okolja, na primer themes/my-theme. Privzeto se uporabi shranjeni imenik kopije za delo, sicer celoten imenik peskovnega okolja. |
--message |
Sporočilo potrditve, privzeto Update from Rudel sandbox. |
Glejte Git.