# Kūrimas

## Kurti iš pagrindinės aplinkos

```bash
wp rudel create --name=alpha --theme=twentytwentyfour
```

Rudel iš pavadinimo ir keturių šešioliktainių simbolių sugeneruoja ID (pavyzdžiui, `alpha-3be7`), klonuoja pagrindinės aplinkos WordPress lenteles į sugeneruotu prefiksu pažymėtas lenteles, nukopijuoja pasirinktą temą į smėlio dėžės katalogą ir įrašo smėlio dėžę į pagrindinės aplinkos WordPress duomenų bazę. Smėlio dėžės `siteurl` ir `home` naudoja pagrindinės aplinkos URL.

Jei `--theme` nenurodytas, Rudel naudoja aktyvią pagrindinės svetainės temą. Tema turi būti įdiegta pagrindinėje aplinkoje. Kartu su dukterine tema nukopijuojama ir jos pagrindinė tema.

Nukopijuojama kiekviena lentelė, kurios prefiksas sutampa su pagrindinės aplinkos lentelių prefiksu, įskaitant `users` ir `usermeta`, bet ne pačios Rudel lenteles. Dabartiniame leidime tai apima ir jau sukurtų smėlio dėžių lenteles, todėl kiekviena nauja smėlio dėžė būna didesnė už ankstesnę. Žr. [issue #3](https://github.com/inline0/rudel/issues/3).

## Kurti iš kitos smėlio dėžės

```bash
wp rudel create --name=feature-b --clone-from=alpha-3be7
```

Nauja smėlio dėžė gauna kiekvienos lentelės su šaltinio smėlio dėžės prefiksu kopiją, įskaitant šaltinio momentinių kopijų lenteles, ir joje esančią temą. Momentinių kopijų katalogai nekopijuojami, todėl tos lentelės naujoje smėlio dėžėje nenaudojamos ([issue #12](https://github.com/inline0/rudel/issues/12)). Jei šaltinio temos katalogas yra Git saugykla, Rudel sukuria susietą darbinį medį šakoje `rudel/{new-id}`, o ne paprastą kopiją. Šaltinio ID įrašomas naujame įraše.

## Gyvavimo ciklo metaduomenys

Smėlio dėžėse gali būti valymui ir nuosavybei skirti metaduomenys:

```bash
wp rudel create \
  --name=feature-a \
  --owner=dennis \
  --labels=agent,qa \
  --purpose="Test checkout changes" \
  --ttl-days=7
```

Naudokite `--protected`, kai automatizuotas valymas neturi pašalinti smėlio dėžės. Žr. [Politika](https://rudel.inline0.dev/lt/docs/features/policy).

## Ribos

Sukurti nepavyksta, kai pasiekiami nustatymai `max_sandboxes` arba `max_disk_mb`. Pagal numatytuosius nustatymus abiejų reikšmė yra `0`, tai reiškia, kad apribojimo nėra. Žr. [Konfigūracija](https://rudel.inline0.dev/lt/docs/configuration).

## Git darbinės kopijos

```bash
wp rudel create --name=feature-a --git=https://example.test/my-theme.git
```

Rudel sukuria smėlio dėžę, klonuoja nuotolinę saugyklą į `themes/my-theme` smėlio dėžės kataloge ir perjungia darbinę kopiją į šaką `rudel/{id}`. Pridėkite `--type=plugin`, kad klonuotumėte į `plugins/my-theme`. Jei klonavimas nepavyksta, smėlio dėžė paliekama, o išvedamas įspėjimas. Informaciją apie tai, ką smėlio dėžė pateikia iš tos darbinės kopijos, rasite [Git](https://rudel.inline0.dev/lt/docs/features/git).

## Katalogų struktūra

```text
wp-content/rudel-environments/{id}/
  themes/       copied theme, plus any Git checkout
  snapshots/    snapshot metadata and theme copies
  logs/ metadata/ tmp/
  wp-cli.yml
  debug.log     when debug logging is active
```