diff --git a/docs/architecture/instance_runtime_files.md b/docs/architecture/instance_runtime_files.md index f8012d91b0d01acf10e0e7e5c18ca83b2932ab40..b81a2c42ae00581e0b76762abf310b3c8c89dda2 100644 --- a/docs/architecture/instance_runtime_files.md +++ b/docs/architecture/instance_runtime_files.md @@ -1,6 +1,6 @@ # Рабочие файлы инÑтанÑа {: #instance_runtime_files } -Ð’ [директории Ñ Ð´Ð°Ð½Ð½Ñ‹Ð¼Ð¸ инÑтанÑа](../reference/cli.md#data_dir) автоматичеÑки поÑвлÑÑŽÑ‚ÑÑ Ñледующие файлы: +Ð’ [директории Ñ Ð´Ð°Ð½Ð½Ñ‹Ð¼Ð¸ инÑтанÑа](../reference/cli.md#run_data_dir) автоматичеÑки поÑвлÑÑŽÑ‚ÑÑ Ñледующие файлы: - `*.snap` — файлы [Ñнапшотов](../overview/glossary.md#snapshot) БД - `*.xlog` — файлы журнала упреждающей запиÑи (Write-ahead log, WAL) c diff --git a/docs/reference/api.md b/docs/reference/api.md index e24c274bd4e417a03b33295f0a4eca31d2f751e8..bdd4e3963ba15ee88b2d582983761d2577c793eb 100644 --- a/docs/reference/api.md +++ b/docs/reference/api.md @@ -113,7 +113,7 @@ function abort_ddl(timeout) ### pico.args {: #pico_args } -Lua-таблица (не функциÑ) Ñ [параметрами запуÑка](cli.md#run_command) инÑтанÑа, +Lua-таблица (не функциÑ) Ñ [параметрами запуÑка](cli.md#run) инÑтанÑа, которые были переданы в виде переменных Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ Ð¸Ð»Ð¸ аргументов командной Ñтроки. diff --git a/docs/reference/audit_events.md b/docs/reference/audit_events.md index c00bd510fdbe189c219bfe1497ee4ec264baaed0..e05b8ebcfc1cd8eaf416e42146f6c177121f7e14 100644 --- a/docs/reference/audit_events.md +++ b/docs/reference/audit_events.md @@ -143,7 +143,7 @@ К данному Ñобытию отноÑитÑÑ Ð¸Ð½Ñ„Ð¾Ñ€Ð¼Ð°Ñ†Ð¸Ñ Ð¾ любом изменении грейда каждого узла клаÑтера, как только оно было зарегиÑтрировано. Плановые -[запуÑк](../reference/cli.md#run_command) и +[запуÑк](../reference/cli.md#run) и [оÑтановка](../reference/api.md#pico_exit) узла ([добавление](../overview/glossary.md#joining) в клаÑтер и [иÑключение](../reference/cli.md#expel) из него ÑоответÑтвенно) ÑвÑзаны diff --git a/docs/reference/cli.md b/docs/reference/cli.md index e20176038a76886a7df81b39893ab358024da109..8c8d334475a5ee93db04b9577d3becd30572003d 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -1,10 +1,16 @@ # Ðргументы командной Ñтроки -Picodata ÑвлÑетÑÑ ÐºÐ¾Ð½Ñольным приложением, которое поддерживает различные параметры запуÑка в виде аргументов командной Ñтроки. +Picodata ÑвлÑетÑÑ ÐºÐ¾Ð½Ñольным приложением, которое поддерживает различные +параметры запуÑка в виде аргументов командной Ñтроки и переменных +окружениÑ. -Полный ÑпиÑок аргументов доÑтупен Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ команды `picodata help`: +<!-- ********************************************************************** --> +## picodata help {: #help } +<!-- ********************************************************************** --> -```console +ÐŸÐ¾Ð»Ð½Ð°Ñ Ñправка доÑтупна Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ команды `picodata help`: + +```txt USAGE: picodata <SUBCOMMAND> @@ -18,227 +24,269 @@ SUBCOMMANDS: expel Expel node from cluster help Print this message or the help of the given subcommand(s) run Run the picodata instance - tarantool Run tarantool test Run picodata integration tests ``` -Ð’ общем Ñлучае поÑле `picodata` Ñледует указать название команды и затем, опционально, параметры: +<!-- ********************************************************************** --> +## picodata run {: #run } +<!-- ********************************************************************** --> -```console -picodata <command> [<params>] +ЗапуÑкает инÑÑ‚Ð°Ð½Ñ Picodata, Ñм. [ЗапуÑк клаÑтера](../tutorial/deploy.md). + +``` +picodata run [OPTIONS] ``` -## Команда `run` {: #run_command } +### --admin-sock {: #run_admin_sock } -ЗапуÑкает инÑÑ‚Ð°Ð½Ñ (ÑкземплÑÑ€) Picodata. +`--admin-sock <path>` -### ИÑпользование {: #run_usage } +Путь к unix-Ñокету Ð´Ð»Ñ Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ команды [picodata +admin](#admin). Данный ÑпоÑоб иÑпользует обычный текÑтовый протокол и +привилегии админиÑтратора. См. [Подключение и работа в конÑоли — КонÑоль +админиÑтратора](../tutorial/connecting.md#admin_console). -``` -picodata run [Параметры] -``` +Значение по умолчанию: `<data_dir>/admin.sock`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_ADMIN_SOCK` -### Параметры {: #run_options } +### --advertise {: #run_advertise } -#### advertise {: #advertise } +`--advertise <[host][:port]>` -`--advertise <[host][:port]>`<br> -ÐдреÑ, по которому другие инÑтанÑÑ‹ Ñмогут подключитьÑÑ Ðº данному инÑтанÑу. По умолчанию иÑпользуетÑÑ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ðµ из аргумента `--listen`. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_ADVERTISE`. +ÐдреÑ, по которому другие инÑтанÑÑ‹ Ñмогут подключитьÑÑ Ðº данному +инÑтанÑу. По умолчанию иÑпользуетÑÑ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ðµ [--listen](#run_listen). -#### cluster-id {: #cluster_id } +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_ADVERTISE` -`--cluster-id <name>`<br> -Ð˜Ð¼Ñ ÐºÐ»Ð°Ñтера. ИнÑÑ‚Ð°Ð½Ñ Ð½Ðµ Ñможет Ñтать чаÑтью клаÑтера, еÑли у него указано другое имÑ. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_CLUSTER_ID`. +### --audit {: #run_audit } -#### admin-sock {: #admin_sock } +`--audit <file>` -`--admin-sock <path>`<br> -Путь к файлу Ñокета, который впоÑледÑтвие можно иÑпользовать Ð´Ð»Ñ -Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ команды [`picodata admin`](#admin_command). Ð’ отличие от Ð¿Ð¾Ð´ÐºÐ»ÑŽÑ‡ÐµÐ½Ð¸Ñ Ðº адреÑу, -указанному в параметре `--listen`, данный ÑпоÑоб иÑпользует обычный -текÑтовый протокол и привилегии админиÑтратора. -По умолчанию ÑоздаетÑÑ Ñокет `admin.sock` в директории `--data-dir`. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: -`PICODATA_ADMIN_SOCK`. +ÐšÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ñ Ð¶ÑƒÑ€Ð½Ð°Ð»Ð° аудита. ДоÑтупны Ñледующие варианты: -#### audit {: #audit } +- `file:<file>` или проÑто `<file>` — запиÑÑŒ в файл +- `pipe:<command>` или `| <command>` — перенаправление вывода в подпроцеÑÑ +- `syslog:` — перенаправление на Ñлужбу `syslog` защищенной ОС -`--audit <file>`<br> -Файл журнала. Данный параметр включает запиÑÑŒ Ñобытий инÑтанÑа в журнал аудита. Ð’ качеÑтве журнала может быть указан: +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_AUDIT_LOG` -- обычный полный или отноÑительный путь к файлу (`/var/audit.log` / `audit.log`) -- перенаправление на внешний обработчик, указанный поÑле вертикального Ñлеша (`| /usr/bin/name-goes-here -v ...`) -- перенаправление на Ñлужбу `syslog` защищенной ОС (`syslog:`) +### --cluster-id {: #run_cluster_id } -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_AUDIT_LOG` +`--cluster-id <name>` + +Ð˜Ð¼Ñ ÐºÐ»Ð°Ñтера. ИнÑÑ‚Ð°Ð½Ñ Ð½Ðµ Ñможет Ñтать чаÑтью клаÑтера, еÑли у него +указано другое имÑ. + +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_CLUSTER_ID` + +### --data-dir {: #run_data_dir } + +`--data-dir <path>` + +Ð Ð°Ð±Ð¾Ñ‡Ð°Ñ Ð´Ð¸Ñ€ÐµÐºÑ‚Ð¾Ñ€Ð¸Ñ Ð¸Ð½ÑтанÑа. ЗдеÑÑŒ Picodata хранит вÑе данные. + +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_DATA_DIR` + +### --failure-domain {: #run_failure_domain } + +`--failure-domain <key=value>` + +СпиÑок параметров географичеÑкого раÑÐ¿Ð¾Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ñервера (через запÑтую). +Также Ñтот аргумент называетÑÑ _зоной доÑтупноÑти_. Каждый параметр +должен быть в формате КЛЮЧ=ЗÐÐЧЕÐИЕ. Также, Ñледует помнить о том, что +добавлÑемый инÑÑ‚Ð°Ð½Ñ Ð´Ð¾Ð»Ð¶ÐµÐ½ обладать тем же набором доменов (Ñ‚.е. ключей +данного аргумента), которые уже еÑÑ‚ÑŒ в клаÑтере. Picodata будет избегать +Ð¿Ð¾Ð¼ÐµÑ‰ÐµÐ½Ð¸Ñ Ð´Ð²ÑƒÑ… инÑтанÑов в один репликаÑет, еÑли Ñ…Ð¾Ñ‚Ñ Ð±Ñ‹ один параметр +зоны доÑтупноÑти у них Ñовпадает. СоответÑтвенно, инÑтанÑÑ‹ будут +формировать новые репликаÑеты. -#### data-dir {: #data_dir } +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_FAILURE_DOMAIN` -`--data-dir <path>`<br> -ДиректориÑ, в которой инÑÑ‚Ð°Ð½Ñ Ð±ÑƒÐ´ÐµÑ‚ ÑохранÑÑ‚ÑŒ Ñвои данные Ð´Ð»Ñ Ð¿Ð¾ÑтоÑнного хранениÑ. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_DATA_DIR`. +### --http-listen {: #run_http_listen } -#### failure-domain {: #failure_domain } +`--http-listen <[host][:port]>` -`--failure-domain <key=value>`<br> -СпиÑок параметров географичеÑкого раÑÐ¿Ð¾Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ñервера (через запÑтую). Также Ñтот аргумент называетÑÑ _зоной доÑтупноÑти_. -Каждый параметр должен быть в формате КЛЮЧ=ЗÐÐЧЕÐИЕ. Также, Ñледует помнить о том, что добавлÑемый инÑÑ‚Ð°Ð½Ñ Ð´Ð¾Ð»Ð¶ÐµÐ½ обладать -тем же набором доменов (Ñ‚.е. ключей данного аргумента), которые уже еÑÑ‚ÑŒ в клаÑтере. -Picodata будет избегать Ð¿Ð¾Ð¼ÐµÑ‰ÐµÐ½Ð¸Ñ Ð´Ð²ÑƒÑ… инÑтанÑов в один репликаÑет, еÑли Ñ…Ð¾Ñ‚Ñ Ð±Ñ‹ один параметр зоны доÑтупноÑти у них Ñовпадает. -СоответÑтвенно, инÑтанÑÑ‹ будут формировать новые репликаÑеты. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_FAILURE_DOMAIN`. -<!-- Picodata Ñледит за тем, чтобы репликаÑеты наполнÑлиÑÑŒ -инÑтанÑами Ñ Ñ€Ð°Ð·Ð½Ñ‹Ð¼Ð¸ зонами доÑтупноÑти до тех пор пока не доÑтигнут заданный фактор репликации. --> +ÐÐ´Ñ€ÐµÑ +[HTTP-Ñервера](https://github.com/tarantool/http){:target="_blank"}. +Ð˜Ð½Ñ‚ÐµÑ€Ñ„ÐµÐ¹Ñ ÐºÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ð¸ Ñервера ÑкÑпортирован в Lua-переменной +`_G.pico.httpd`. При отÑутÑтвии параметра Ñервер не запуÑкаетÑÑ, а +ÑƒÐºÐ°Ð·Ð°Ð½Ð½Ð°Ñ Lua-Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¸Ð¼ÐµÐµÑ‚ зачение `nil`. -#### help {: #help } +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_HTTP_LISTEN` -`-h, --help`<br> -Вывод Ñправочной информации. +### --init-cfg {: #run_init_cfg } -#### http-listen {: #http_listen } +`--init-cfg <PATH>` -`--http-listen <[host][:port]>` <br> -ÐдреÑ, на котором будет доÑтупен запущенный -[HTTP-Ñервер](https://github.com/tarantool/http){:target="_blank" }. Ð”Ð»Ñ -работы Ñ API маршрутизации в Lua Ñледует иÑпользовать переменную -`_G.pico.httpd`. Сервер будет запущен только при Ñвном указании -`--http-listen` Ñ ÐºÐ¾Ñ€Ñ€ÐµÐºÑ‚Ð½Ñ‹Ð¼ адреÑом.<br> ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ -окружениÑ: `PICODATA_HTTP_LISTEN`. +Путь к файлу конфигурации, иÑпользуемый при бутÑтрапе клаÑтера. -#### interactive {: #interactive } +Данный параметр не ÑочетаетÑÑ Ñ `--init-replication-factor`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INIT_CFG` -`-i, --interactive`<br> -ЗапуÑк интерактивной конÑоли. <br> ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: -`PICODATA_INTERACTIVE_MODE`. +### --init-replication-factor {: #run_init_replication_factor } -#### init-replication-factor {: #init_replication_factor } +`--init-replication-factor <INIT_REPLICATION_FACTOR>` -`--init-replication-factor <INIT_REPLICATION_FACTOR>`<br> -ЧиÑло реплик (инÑтанÑов Ñ Ð¾Ð´Ð¸Ð½Ð°ÐºÐ¾Ð²Ñ‹Ð¼ набором хранимых данных) Ð´Ð»Ñ ÐºÐ°Ð¶Ð´Ð¾Ð³Ð¾ репликаÑета. -Данный параметр не может иÑпользоватьÑÑ Ð¾Ð´Ð½Ð¾Ð²Ñ€ÐµÐ¼ÐµÐ½Ð½Ð¾ Ñ [init-cfg](#init_cfg). -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INIT_REPLICATION_FACTOR`. +ЧиÑло реплик (инÑтанÑов Ñ Ð¾Ð´Ð¸Ð½Ð°ÐºÐ¾Ð²Ñ‹Ð¼ набором хранимых данных) Ð´Ð»Ñ +каждого репликаÑета. -#### instance-id {: #instance_id } +Данный параметр не ÑочетаетÑÑ Ñ `--init-cfg`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INIT_REPLICATION_FACTOR` -`--instance-id <name>`<br> -Ðазвание инÑтанÑа. ЕÑли Ñтот аргумент не указать, то название будет Ñгенерировано автоматичеÑки. -Данный аргумент удобно иÑпользовать Ð´Ð»Ñ Ñвного ÑƒÐºÐ°Ð·Ð°Ð½Ð¸Ñ Ð¸Ð½ÑтанÑа при его перезапуÑке -(например, в Ñлучае его недоÑтупноÑти или при переноÑе в другую Ñеть). -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INSTANCE_ID`. +### --instance-id {: #run_instance_id } -#### listen {: #listen } +`--instance-id <name>` -`-l, --listen <[host][:port]>`<br> -ÐÐ´Ñ€ÐµÑ Ð¸ порт привÑзки инÑтанÑа. По умолчанию иÑпользуетÑÑ localhost:3301 -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_LISTEN`. +Ðазвание инÑтанÑа. При отÑутÑтвии параметра, значение будет +автоматичеÑки Ñгенерировано raft-лидером в момент приÑÐ¾ÐµÐ´Ð¸Ð½ÐµÐ½Ð¸Ñ +(joining) инÑтанÑа к клаÑтеру. -#### log-level {: #log_level } +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INSTANCE_ID` -`--log-level <LOG_LEVEL>`<br> -Уровень региÑтрации Ñобытий. Возможные значениÑ: fatal, system, error, crit, warn, info, verbose, debug. -По умолчанию иÑпользуетÑÑ ÑƒÑ€Ð¾Ð²ÐµÐ½ÑŒ info. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_LOG_LEVEL`. +### --listen {: #run_listen } -#### peer {: #peer } +`-l, --listen <[host][:port]>` -`--peer <[host][:port]>`<br> -Один или неÑколько адреÑов других инÑтанÑов (через запÑтую). По -умолчанию иÑпользуетÑÑ Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ðµ localhost:3301. Указание порта -опционально. ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_PEER`. +ÐÐ´Ñ€ÐµÑ Ð¸ порт привÑзки инÑтанÑа. -#### replicaset-id {: #replicaset_id } +Значение по умолчанию: `localhost:3301`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_LISTEN` -`--replicaset-id <name>`<br> -Ð˜Ð¼Ñ Ñ€ÐµÐ¿Ð»Ð¸ÐºÐ°Ñета. ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_REPLICASET_ID` +### --log-level {: #run_log_level } -#### script {: #script } +`--log-level <LOG_LEVEL>` -`--script <path>`<br> -Путь к файлу Lua-Ñкрипта, который будет выполнен поÑле приÑÐ¾ÐµÐ´Ð¸Ð½ÐµÐ½Ð¸Ñ Ð¸Ð½ÑтанÑа к клаÑтеру. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_SCRIPT`. +Уровень важноÑти Ñобытий, региÑтрируемых в отладочном журнале. -#### init-cfg {: #init_cfg } +Возможные значениÑ: `fatal`, `system`, `error`, `crit`, `warn`, `info`, +`verbose`, `debug`<br> +Значение по умолчанию: `info`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_LOG_LEVEL` -`--init-cfg <path>`<br> -ОтноÑительный или абÑолютный путь к конфигурационному файлу.<!--[конфигурационному файлу](../tutorial/deploy.md#init-cfg)--> -Данный параметр не может иÑпользоватьÑÑ Ð¾Ð´Ð½Ð¾Ð²Ñ€ÐµÐ¼ÐµÐ½Ð½Ð¾ Ñ [init-replication-factor](#init_replication_factor). ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INIT_CFG`. +### --peer {: #run_peer } -#### tier {: #tier } +`--peer <[host][:port]>` + +Один или неÑколько адреÑов других инÑтанÑов через запÑтую. + +Значение по умолчанию: `localhost:3301`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_PEER` + +### --replicaset-id {: #run_replicaset_id } + +`--replicaset-id <name>` + +Ð˜Ð¼Ñ Ñ€ÐµÐ¿Ð»Ð¸ÐºÐ°Ñета. При отÑутÑтвии параметра, значение будет +автоматичеÑки выбрано raft-лидером в момент приÑÐ¾ÐµÐ´Ð¸Ð½ÐµÐ½Ð¸Ñ +(joining) инÑтанÑа к клаÑтеру. + +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_REPLICASET_ID` + +### --script {: #run_script } + +`--script <path>` + +Путь к файлу Lua-Ñкрипта, который будет выполнен поÑле приÑÐ¾ÐµÐ´Ð¸Ð½ÐµÐ½Ð¸Ñ +инÑтанÑа к клаÑтеру. + +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_SCRIPT` + +### --tier {: #run_tier } + +`--tier <tier>` -`--tier <tier>` <br> Ðазвание [тира](../overview/glossary.md#tier), которому будет -принадлежать инÑтанÑ. ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: -`PICODATA_INSTANCE_TIER`. +принадлежать инÑтанÑ. -#### shredding {: #shredding } +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_INSTANCE_TIER` -`--shredding` <br> -Включение режима перезапиÑи (Ð·Ð°Ð¿Ð¾Ð»Ð½ÐµÐ½Ð¸Ñ Ñлучайными данными и Ñпециализированными -паттернами) уÑтаревших файлов `.xlog` и `.snap` перед их удалением Ñ -целью ÑÐºÑ€Ñ‹Ñ‚Ð¸Ñ Ð¸Ñ… Ñодержимого. -ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: -`PICODATA_SHREDDING`. +### --shredding {: #run_shredding } -## Команда `connect` {: #connect_command } +`--shredding` -ПодключаетÑÑ Ðº указанному инÑтанÑу и открывает интерактивную SQL-конÑоль. +Режим многократной перезапиÑи Ñпециальными битовыми поÑледовательноÑÑ‚Ñми +файлов `.xlog` и `.snap` при их удалении. -### ИÑпользование {: #connect_usage } +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_SHREDDING` -``` -picodata connect [Параметры] <Ðргументы> -``` -### Ðргументы {: #connect_arguments } +<!-- ********************************************************************** --> +## picodata admin {: #admin } +<!-- ********************************************************************** --> -`ADDRESS`: ÐÐ´Ñ€ÐµÑ Ð¸Ð½ÑтанÑа Picodata в формате `[user@][host][:port]`. -<!-- При указании неполного адреÑа, -недоÑÑ‚Ð°ÑŽÑ‰Ð°Ñ Ñ‡Ð°ÑÑ‚ÑŒ будет взÑта из значений по умолчанию (текущий хоÑÑ‚, -порт 3301). По умолчанию подключение производитÑÑ Ð¿Ð¾Ð´ пользователем -`guest` и пуÑтым паролем.--> +ПодключаетÑÑ Ðº конÑоли админиÑтратора, cм. [Подключение и работа в +конÑоли — КонÑоль +админиÑтратора](../tutorial/connecting.md#admin_console). -### Параметры {: #connect_options } +``` +picodata admin <PATH> +``` -- `-a, --auth_type <METHOD>`, тип аутентификации. По умолчанию - иÑпользуетÑÑ `chap-sha1`, также доÑтупны `md5` и `ldap`. -- `-h, --help`, вывод Ñправки о команде `connect`. -- `-u, --user <USER>`, пользователь, под которым будет инициировано - подключение. ЕÑли пользователь указан в рамках `<ADDRESS>` (например, - `user@localhost:3301`), то параметр `--user` будет проигнорирован. - ЕÑли Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð½Ðµ указывать, то будет иÑпользован пользователь по - умолчанию (`guest`). -- `--password-file`, путь к файлу Ñ Ð¿Ð°Ñ€Ð¾Ð»ÐµÐ¼ указанного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ - (хранитÑÑ Ð² виде обычного текÑта). Без Ñтого параметра пароль будет - запрошен в интерактивном режиме. Путь к файлу Ð¿Ð°Ñ€Ð¾Ð»Ñ Ð¼Ð¾Ð¶Ð½Ð¾ также - передать через переменную Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ `PICODATA_PASSWORD_FILE`. +- `PATH`: Путь unix-Ñокета, ÑоответÑтвующий опции [picodata run + --admin-sock](#run_admin_sock) -### Пример {: #connect_example } +**Пример** ```console -picodata connect localhost:3301 +$ picodata admin ./admin.sock +Connected to admin console by socket path "admin.sock" +type '\help' for interactive help +picodata> ``` -### Подключение под определенным пользователем {: #connect_user } -```console -picodata connect --user user_name localhost:3301 +<!-- ********************************************************************** --> +## picodata connect {: #connect } +<!-- ********************************************************************** --> + +ПодключаетÑÑ Ðº клаÑтерной SQL-конÑоли. См. [ПользовательÑÐºÐ°Ñ +конÑоль](../tutorial/connecting.md#sql_console) + +``` +picodata connect [OPTIONS] <ADDRESS> ``` -### Передача Ð¿Ð°Ñ€Ð¾Ð»Ñ Ð² файле {: #password_file } +- `ADDRESS`: ÐÐ´Ñ€ÐµÑ Ð¸Ð½ÑтанÑа Picodata в формате `[user@][host][:port]`, + ÑоответÑтвующий опции [picodata run --adverse](#run_advertise). -```console -picodata connect --user user_name --password-file ~/vault/user_name_pass.txt localhost:3301 +**Пример** + +```bash +$ picodata connect alice@localhost:3301 +Enter password for alice: +Connected to interactive console by address "localhost:3301" under "alice" user +type '\help' for interactive help +picodata> ``` -Путь к файлу Ð¿Ð°Ñ€Ð¾Ð»Ñ Ð¼Ð¾Ð¶ÐµÑ‚ быть как отноÑительным, так и абÑолютным. +### -a, --auth-type {: #connect_auth_type } + +`-a, --auth_type <METHOD>` + +Метод аутентификации, Ñм. [ÐÑƒÑ‚ÐµÐ½Ñ‚Ð¸Ñ„Ð¸ÐºÐ°Ñ†Ð¸Ñ Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ LDAP](../tutorial/ldap.md). + +Возможные значениÑ: `chap-sha1`, `ldap`, `md5`<br> +Значение по умолчанию: `chap-sha1`<br>. + +### -u, --user {: #connect_user } -### Блокировка при неудачном входе {: #failed_login_attempt } +`-u, --user <USER>` -По умолчанию, поÑле 4 попыток неудачного входа ÑƒÑ‡ÐµÑ‚Ð½Ð°Ñ Ð·Ð°Ð¿Ð¸ÑÑŒ -Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð±Ð»Ð¾ÐºÐ¸Ñ€ÑƒÐµÑ‚ÑÑ Ð½Ð° текущем инÑтанÑе. ПерезапуÑк инÑтанÑа -ÑбраÑывает Ñчетчик попыток и позволÑет разблокировать пользователÑ. +Ð˜Ð¼Ñ Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ, Ñм. [Управление доÑтупом](../tutorial/access_control.md#user_management). + +ИгнорируетÑÑ Ð¿Ñ€Ð¸ указании имени Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ Ð² адреÑе<br> +Значение по умолчанию: `guest` + +### --password-file {: #connect_password_file } + +`--password-file` + +Путь к файлу Ñ Ð¿Ð°Ñ€Ð¾Ð»ÐµÐ¼ указанного Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ÐµÐ»Ñ (хранитÑÑ Ð² виде обычного +текÑта). Без Ñтого параметра пароль будет запрошен в интерактивном +режиме. + +Значение по умолчанию: `localhost:3301`<br> +ÐÐ½Ð°Ð»Ð¾Ð³Ð¸Ñ‡Ð½Ð°Ñ Ð¿ÐµÑ€ÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¾ÐºÑ€ÑƒÐ¶ÐµÐ½Ð¸Ñ: `PICODATA_PASSWORD_FILE` <!-- ### ЧиÑло попыток неудачного входа {: #max_login_attempts } @@ -261,75 +309,40 @@ picodata> pico.cas({ ``` --> -Cм. также: -- [SQL-конÑоль](../tutorial/connecting.md#sql_console) +<!-- ********************************************************************** --> +## picodata expel {: #expel } +<!-- ********************************************************************** --> -## Команда `admin` {: #admin_command } - -ПодключаетÑÑ Ðº конÑоли админиÑтратора. - -### ИÑпользование {: #admin_usage } +ИÑключает инÑÑ‚Ð°Ð½Ñ Picodata из ÑоÑтава клаÑтера. ``` -picodata admin <Ðргументы> +picodata expel [OPTIONS] ``` -### Ðргументы {: #admin_arguments } +### --cluster-id {: #expel_cluster_id } -`PATH`: Путь к файлу юникÑ-Ñокета, который был передан в качеÑтве параметра -[`--admin-sock`](#admin_sock) при Ñтарте инÑтанÑа. +`--cluster-id <name>` -### Пример {: #admin_example } +Ð˜Ð¼Ñ ÐºÐ»Ð°Ñтера, из которого должен быть иÑключен инÑтанÑ. -```console -picodata admin i1/admin.sock -``` - -Cм. также: - -- [КонÑоль админиÑтратора](../tutorial/connecting.md#admin_console) +Значение по умолчанию: `demo` +### --instance-id {: #expel_instance_id } -## Команда `tarantool` {: #tarantool_command } +`--instance-id <name>` -ЗапуÑкает Tarantool и открывает его конÑоль. +Ð˜Ð¼Ñ Ð¸Ð½ÑтанÑа, который Ñледует иÑключить. -<!-- Открывает конÑоль c Lua-интерпретатором, в котором можно -взаимодейÑтвовать Ñ Ð¡Ð£Ð‘Ð” аналогично тому, как Ñто проиÑходит в обычной -конÑоли Tarantool. ÐÐ¸ÐºÐ°ÐºÐ°Ñ Ð»Ð¾Ð³Ð¸ÐºÐ° Picodata поверх Tarantool не -выполнÑетÑÑ, ÑоответÑтвенно, клаÑтер не инициализируетÑÑ Ð¸ подключение к -клаÑтеру не производитÑÑ. ЗапуÑкаетÑÑ ÐºÐ¾Ð½Ñоль ÑкземплÑра Tarantool, -вÑтроенного в Picodata (но не уÑтановленного обычного Tarantool, еÑли -такой еÑÑ‚ÑŒ в ÑиÑтеме).--> +### --peer {: #expel_peer } -### ИÑпользование {: #tarantool_usage } +`--peer <[host][:port]>` -``` -picodata tarantool [Параметры] -``` +ÐÐ´Ñ€ÐµÑ Ð»ÑŽÐ±Ð¾Ð³Ð¾ инÑтанÑа из ÑоÑтава клаÑтера. -### Параметры {: #tarantool_options } - -- `-h, --help`, вывод Ñправки о команде `tarantool`. - -## Команда `expel` {: #expel } - -ИÑключает инÑÑ‚Ð°Ð½Ñ Picodata из ÑоÑтава клаÑтера. - -### ИÑпользование {: #expel_usage } - -``` -picodata expel [Параметры] -``` - -### Параметры {: #expel_options } - -- `--cluster-id <name>`, Ð¸Ð¼Ñ ÐºÐ»Ð°Ñтера, из которого должен быть иÑключен инÑÑ‚Ð°Ð½Ñ (по умолчанию Ñто `demo`). -- `-h, --help`, вывод Ñправки о команде `expel`. -- `--instance-id <name>`, Ð¸Ð¼Ñ Ð¸Ð½ÑтанÑа, который Ñледует иÑключить (без ÑƒÐºÐ°Ð·Ð°Ð½Ð¸Ñ Ð¸Ð¼ÐµÐ½Ð¸ `expel` не имеет Ñилы). -- `--peer <[host][:port]>`, Ð°Ð´Ñ€ÐµÑ Ð»ÑŽÐ±Ð¾Ð³Ð¾ инÑтанÑа из ÑоÑтава клаÑтера (по умолчанию Ñто `localhost:3301`). +Значение по умолчанию: `localhost:3301` +<!-- ## Сценарии Ð¿Ñ€Ð¸Ð¼ÐµÐ½ÐµÐ½Ð¸Ñ ÐºÐ¾Ð¼Ð°Ð½Ð´ {: #cases } Ðиже приведены типовые Ñитуации и подходÑщие Ð´Ð»Ñ Ñтого команды. @@ -364,5 +377,4 @@ picodata expel [Параметры] ÑамоÑтоÑтельно найдет лидера клаÑтера и отправит ему команду на иÑключение инÑтанÑа `i3`. Когда процеÑÑ `picodata` на i3 завершитÑÑ â€” Ñервер можно выключать. - -Подробнее об уÑтройÑтве клаÑтера и репликаÑетов Picodata Ñм. в разделе [ЗапуÑк клаÑтера](../tutorial/deploy.md). +--> diff --git a/docs/tutorial/access_control.md b/docs/tutorial/access_control.md index 74078445a5a2ecf132a1541271031741679f37be..6de2398c9c61f5fe05bc4377d587b76923583f78 100644 --- a/docs/tutorial/access_control.md +++ b/docs/tutorial/access_control.md @@ -105,8 +105,8 @@ GRANT DROP ROLE TO "admin" Однако, у него по умолчанию отÑутÑтвует Ð¿Ñ€Ð¸Ð²Ð¸Ð»ÐµÐ³Ð¸Ñ `SESSION`. ИÑпользовать учетную запиÑÑŒ можно подключившиÑÑŒ к -[конÑоли админиÑтратора](../reference/cli.md#admin_sock) -командой [`picodata admin`](../reference/cli.md#admin_command) +[конÑоли админиÑтратора](../reference/cli.md#run_admin_sock) +командой [`picodata admin`](../reference/cli.md#admin) <!-- #### ГоÑÑ‚ÑŒ {: #guest } diff --git a/docs/tutorial/audit_log.md b/docs/tutorial/audit_log.md index f6d26d9dbe4b03e988d6f62b351597665f7dc756..a35acef67541895ba1c7fbbd9fb49656719193c6 100644 --- a/docs/tutorial/audit_log.md +++ b/docs/tutorial/audit_log.md @@ -78,7 +78,7 @@ API, предоÑтавлÑемых Ñамой СУБД. ## Включение журнала {: #enable_audit_log } По умолчанию, запиÑÑŒ Ñобытий не ведетÑÑ. Включить журнал можно при -[запуÑке инÑтанÑа](../reference/cli.md#audit) +[запуÑке инÑтанÑа](../reference/cli.md#run_audit) <!-- - Ñ Ð¿Ð¾Ð¼Ð¾Ñ‰ÑŒÑŽ API-функции [pico.audit()](../reference/api.md#picoaudit) --> Ð”Ð»Ñ Ð¿Ñ€Ð¸Ð¼ÐµÑ€Ð°, задейÑтвуем файл журнала при запуÑке инÑтанÑа: diff --git a/docs/tutorial/connecting.md b/docs/tutorial/connecting.md index 0258b8ff91901eaee3f56dd49bb15cb82939f7d7..88c6c4015103684ed7df8fb9931ae0ba2fb269de 100644 --- a/docs/tutorial/connecting.md +++ b/docs/tutorial/connecting.md @@ -4,7 +4,7 @@ шаги в конÑоли. По умолчанию, конÑоль, в которой проиÑходит -[запуÑк](../reference/cli.md#run_command) инÑтанÑа Picodata, Ñлужит Ð´Ð»Ñ +[запуÑк](../reference/cli.md#run) инÑтанÑа Picodata, Ñлужит Ð´Ð»Ñ Ð²Ñ‹Ð²Ð¾Ð´Ð° диагноÑтичеÑких Ñообщений инÑтанÑа. Ð”Ð»Ñ Ð²Ð²Ð¾Ð´Ð° команд Ñледует подключитьÑÑ Ðº Picodata из другой конÑоли. При Ñтом, возможны два типа подключениÑ: @@ -27,9 +27,9 @@ picodata admin ./admin.sock ``` По умолчанию файл unix-Ñокета раÑположен в [директории Ñ Ð´Ð°Ð½Ð½Ñ‹Ð¼Ð¸ -инÑтанÑа](../reference/cli.md#data_dir) Picodata. Размещение Ñтого +инÑтанÑа](../reference/cli.md#run_data_dir) Picodata. Размещение Ñтого файла наÑтраиваетÑÑ Ð¿Ñ€Ð¸ запуÑке инÑтанÑа параметром -[picodata run --admin-sock](../reference/cli.md#admin_sock). +[picodata run --admin-sock](../reference/cli.md#run_admin_sock). При уÑпешном подключении отобразитÑÑ Ð¿Ñ€Ð¸Ð³Ð»Ð°ÑˆÐµÐ½Ð¸Ðµ: diff --git a/docs/tutorial/webui.md b/docs/tutorial/webui.md index e86bc0d8cf1adc48e77fa7248a6e1879f63ecb40..2a58ee265d6fcb3e88af2da2d50b8444ab8f4513 100644 --- a/docs/tutorial/webui.md +++ b/docs/tutorial/webui.md @@ -23,7 +23,7 @@ Picodata](install.md). Ð”Ð»Ñ Ð·Ð°Ð¿ÑƒÑка инÑтанÑа Ñ Ð²ÐµÐ±-Ñервером Ñледует иÑпользовать дополнительный параметр `--http-listen` Ñ ÑƒÐºÐ°Ð·Ð°Ð½Ð¸ÐµÐ¼ [хоÑта и -порта](../reference/cli.md#http_listen). Пример команды: +порта](../reference/cli.md#run_http_listen). Пример команды: ```bash picodata run --http-listen localhost:8080