> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenderly.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Шпаргалка по CLI

> Следуйте пошаговому руководству и шпаргалке команд CLI для инициализации, сборки и развёртывания Web3 Actions.

Это руководство показывает команды, необходимые для инициализации, сборки и развёртывания проекта Web3 Action с помощью Tenderly CLI.

**Шаг 1: Установите Tenderly CLI**

Используйте команду `curl`, чтобы скачать и установить бинарник Tenderly CLI на вашу локальную машину.

Установка на macOS:

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl https://raw.githubusercontent.com/Tenderly/tenderly-cli/master/scripts/install-macos.sh | sh
```

Установка на Linux:

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl https://raw.githubusercontent.com/Tenderly/tenderly-cli/master/scripts/install-linux.sh | sh
```

**Шаг 2: Войдите в Tenderly через CLI**

Войдите в Tenderly CLI с вашими учётными данными, выполнив эту команду:

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
tenderly login
```

**Шаг 3: Инициализируйте проект Web3 Actions**

Чтобы инициализировать проект Web3 Action, выполните эту команду:

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
tenderly actions init
```

Вы можете изменить настройки инициализации по умолчанию с помощью двух флагов: изменить имя корневой папки Web3 Actions (по умолчанию: `actions`) и язык для написания функций Action (по умолчанию: `typescript` или `javascript`).

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
tenderly actions init --sources=actions --language=typescript
```

Вам будет предложено добавить ваши Web3 Actions в проект Tenderly. Вы можете либо создать новый проект, либо выбрать существующий.

**Шаг 3**: **Установите необходимые NPM-зависимости**

После запуска `tenderly init` в вашем распоряжении есть NPM-проект, поэтому вы можете устанавливать любые нужные npm-библиотеки привычным способом.

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
cd actions
npm i --save-dev axios ethers
cd ..
```

**Шаг 4: Соберите и разверните Web3 Actions**

После того как вы написали функцию и конфигурацию триггера в **tenderly.yaml**, вы можете выполнить эти команды для сборки и развёртывания Web3 Action.

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
# run within the folder containing tenderly.yaml

# Build the project (optional)
tenderly actions build

# Publish the project to Tenderly without running it (start manually)
tenderly actions publish

# Deploy the project to Tenderly Runtime (or re-deploy any changes you make)
tenderly actions deploy
```

Вскоре после выполнения `publish` ваш Web3 Action становится доступным в Dashboard и начинает отслеживать события в соответствии с вашей конфигурацией.

<Note>
  Вы можете обновлять свои Web3 Actions без простоя, выполнив команду `publish` после
  того, как вы отредактировали функцию и конфигурацию триггера.
</Note>

**Опционально: Валидация вашего tenderly.yaml**

Перед развёртыванием вы можете локально проверить структуру и конфигурацию триггеров вашего `tenderly.yaml`. Вход в систему не требуется.

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
# Validate all projects in tenderly.yaml
tenderly actions validate

# Validate a single project only
tenderly actions validate --project username/project-slug

# Machine-readable JSON output (useful in CI pipelines)
tenderly actions validate --json
```

Флаг `--json` выводит структурированный результат. Когда всё валидно:

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{ "valid": true }
```

При неудачной валидации включаются `schema_errors` и/или `trigger_errors` (опускаются, если пусты):

```json theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
  "valid": false,
  "schema_errors": ["..."],
  "trigger_errors": [
    { "project": "my-org/my-project", "action": "myAction", "errors": ["..."] }
  ]
}
```

**Опционально: Обзор поддерживаемых возможностей**

Чтобы увидеть машиночитаемый манифест всех поддерживаемых типов триггеров, runtime, типов выполнения и интервалов:

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
# Print the capabilities manifest
tenderly actions capabilities

# Include the full embedded JSON Schema in the output
tenderly actions capabilities --include-schema
```

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

**Опционально: Использование Tenderly Runtime локально**

Установите пакет [**@tenderly/actions-test**](https://github.com/Tenderly/tenderly-actions/tree/main/packages/actions-test) для локального тестирования функций Web3 Action.

Предполагая, что вы уже находитесь в npm-проекте, выполните следующее:

```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
npm install @tenderly/actions-test
```

<Note>
  Рекомендуется держать тесты и скрипты запуска для web3-actions вне каталога actions,
  чтобы не увеличивать размер вашего проекта Web3 Actions.
</Note>

Ознакомьтесь с [руководством по локальной разработке и тестированию Web3 Actions](/monitoring/web3-actions/references/local-development) для получения дополнительных подробностей и примеров.