# General Translation Platform: Образ виртуальной машины
URL: https://generaltranslation.com/ru/docs/platform/locadex/reference/vm-image.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Ознакомьтесь со средами выполнения, инструментами командной строки и ограничениями, доступными для автоматизаций. Справочник по образу виртуальной машины Locadex.

Песочница, в которой Locadex запускает каждую автоматизацию, устанавливает зависимости, выполняет настроенные команды, обновляет файлы и подготавливает изменения для pull request.

## Среда выполнения [#runtime]

Все провайдеры песочниц используют Node.js 24 и включают:

* Node.js 24 и npm.
* Bun 1.3.9.
* Python 3.13.

При установке зависимостей проекта Locadex использует менеджер пакетов, выбранный для автоматизации.

Python 3.13 помечен как внешне управляемый (externally managed). Команда `python3 -m venv` создаёт окружение, в `PATH` которого доступен `pip`. Чтобы установить пакеты в системный интерпретатор, используйте `python3 -m pip install --break-system-packages`.

Базовый образ Linux зависит от провайдера песочницы. Не рассчитывайте на доступность `apt`, `dnf` или другого менеджера пакетов операционной системы в каждом запуске.

## Переменные окружения [#environment-variables]

Переменные окружения, настроенные по адресу `/org/{orgId}/locadex/secrets`, передаются в песочницу при запуске автоматизаций. Замените `{orgId}` на ID вашей Organization; страница Secrets в настоящее время не отображается на боковой панели Dashboard.

Используйте их для API-ключей, токенов или настройки команд. (Требования к доступу и настройку см. в разделе [Добавление переменных окружения](/docs/platform/locadex/guides/adding-environment-variables)).

## Инструменты командной строки [#tools]

Каждая песочница включает:

* `git`
* `wget`
* `curl`
* `tar`
* `unzip`
* Python 3.13
* `uv` 0.13.1
* `ripgrep`
* `jq`
* `ca-certificates`
* Набор инструментов для сборки C/C++ нативных пакетов

Каждый провайдер также глобально устанавливает `biome`, `eslint` и `ultracite`. Locadex может запускать эти проверки из пресета без добавления инструментов в манифест пакета или lockfile. Если команда вызывает `tsc`, используйте зависимость TypeScript проекта.

## Команды проекта [#commands]

Команды предварительной и последующей обработки запускаются из корневого каталога репозитория. Для монорепозиториев настройте **целевой каталог** автоматизации и убедитесь, что команды выполняются для правильного приложения.

Зависимости проекта не включены в образ виртуальной машины. Добавьте команду установки или настройки, если выбранный менеджер пакетов не может автоматически установить всё необходимое для проекта. (См. [Настройка автоматизаций Locadex](/docs/platform/locadex/guides/configuring-automations#configure-automation)).

## Ограничения [#limitations]

В среде песочницы отсутствуют:

* Среды выполнения браузеров. Если браузер нужен для end-to-end-теста или сборки, установите его в команде.
* Docker-in-Docker. Команды не могут запускать соседние контейнеры или демон Docker внутри песочницы.
* Глобальные инструменты, специфичные для проекта, помимо перечисленных пресетов. Установите их через проект или команду предварительной обработки.

Не полагайтесь на то, что состояние песочницы сохранится между запусками. Locadex может возобновить архивированную песочницу для следующего запуска, однако архивированные песочницы удаляются через 30 дней, а могут быть заменены чистой песочницей и раньше. Храните результаты работы, которые нужно сохранить, в Git и используйте неинтерактивные команды, выполняемые локально в репозитории, чтобы одну и ту же автоматизацию можно было запустить как из возобновлённой, так и из чистой песочницы.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
