# 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į.

```php
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`:

```bash
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname
```

## create

```bash
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](https://rudel.inline0.dev/lt/docs/features/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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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](https://rudel.inline0.dev/lt/docs/features/cleanup).

## logs

```bash
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](https://rudel.inline0.dev/lt/docs/features/logging).

## snapshot

```bash
wp rudel snapshot <id> --name=<name>
```

Sukuria pavadintą momentinę kopiją.

## restore

```bash
wp rudel restore <id> --snapshot=<name> [--force]
```

Atkuria momentinę kopiją. Komanda prašo patvirtinti; `--force` praleidžia šį raginimą. Žr. [Momentinės kopijos](https://rudel.inline0.dev/lt/docs/features/snapshots).

## template

```bash
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](https://rudel.inline0.dev/lt/docs/features/templates).

## push

```bash
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](https://rudel.inline0.dev/lt/docs/features/git).