Собрать, упаковать и выложить проект

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

Для проекта VibeVM в текущей папке покажи мне план выкладки для профиля с именем local, затем выполни выкладку, перечисли выкладки, которые теперь есть на этой машине, и наконец сними тот же профиль. Остановись и спроси меня перед выкладкой и перед снятием. навык vibevm, установленный у вашего агента; проект, чей манифест объявляет артефакт сборки, цель выкладки с механизмом `deploy:vibe-bin` и профиль с именем `local`, как показывают таблицы на этой странице; `cargo` в `PATH` план называет цели по порядку; после выкладки `vibe deployments` показывает профиль с поколением и статусом; после снятия каждый ресурс, которым владела квитанция, исчез, а список показывает профиль как снятый vibe deploy --plan --profile local vibe deployments --json

`vibe deploy --plan` прогоняет весь [жизненный цикл](../glossary/index.xml#lifecycle) `default` в режиме планирования и печатает, что сделала бы каждая [фаза](../glossary/index.xml#phase), заканчивая упорядоченными целями профиля; ничего не записывается. Настоящий `vibe deploy` затем проверяет, ставит, генерирует, собирает, тестирует, создаёт, верифицирует и упаковывает, пропуская каждый шаг, чьи входы не изменились, и применяет упакованные артефакты к целям профиля по порядку. На каждый созданный ресурс он пишет *[квитанцию](../glossary/index.xml#receipt)*: что и куда положено, под каким поколением, каким профилем владеется. `vibe deployments` читает квитанции, которые есть на этой машине. `vibe undeploy --profile local` обходит квитанции в обратном порядке зависимостей и удаляет ровно то, чем они владеют, отказываясь трогать путь, который изменился после выкладки.

1. Объявите, что собирать, что выкладывать и куда. Цель называет артефакт и механизм, который его размещает; профиль — упорядоченный список целей:

[[artifacts.build]] id = "build-hello" mechanism = "build:cargo" outputs = [{ id = "hello", kind = "executable", select = { package = "hello", bin = "hello" } }] config = { offline = true } [[deploy.target]] id = "local" artifact = "hello" mechanism = "deploy:vibe-bin" config = { command = "hello" } [deploy] default_profile = "local" [deploy.profiles.local] targets = ["local"]

Механизм `deploy:vibe-bin` размещает исполняемый файл как лаунчер в собственной папке `bin/` vibe на этой машине. После этого команда запускается из любого терминала; остальные механизмы перечислены в [спецификации](../glossary/index.xml#specification).

2. Соберите дистрибутивы, не трогая ни одного места назначения:

3. Посмотрите план для профиля, затем выложите его:

4. Перечислите, что есть на этой машине, и снимите профиль:

`vibe undeploy --profile <name>` откатывает этот профиль. Список никогда не показывает секретов.

[Манифест](../glossary/index.xml#manifest) объявляет, что производит `build` и что собирает `package`, как цели-артефакты с зависимостями между ними. vibe сводит их в один проверенный граф и записывает каждый произведённый артефакт. Поэтому `package` потребляет ровно то, что проверил `build`, а `deploy` применяет ровно то, что собрал `package`. Артефакт или цель может объявить операционные системы, к которым относится, и цель, которая к текущей машине не относится, пропускается с пометкой.

[Профиль выкладки](../glossary/index.xml#deploy-profile) называет свои цели по порядку и [провайдера](../glossary/index.xml#provider), который применяет каждую: папка на этой машине, проектная или пользовательская конфигурация агента и те жанры, что перечисляет спецификация. Установленный пакет может заменить встроенного провайдера точным пином, так что команда может поставлять собственный способ выкладки.

Две выкладки одного профиля не гоняются наперегонки: движок берёт замок от столкновений на профиль, и вторая ждёт или отказывается, но никогда не перемешивается с первой.

Квитанция — единственное основание для удаления. Если файл, которым владеет квитанция, правили после выкладки, `undeploy` оставляет его на месте и говорит об этом, вместо того чтобы удалить чью-то работу.

`--force` у глагола жизненного цикла игнорирует записанные [отпечатки](../glossary/index.xml#fingerprint) на один прогон; смысла прогона он не меняет.

Фаза выкладки применяет упакованные артефакты и ничего больше: шаг, которому нужен агент, например написать заметки о выпуске, принадлежит `create` и выполняется, только когда проект его включает.