Help:XSvacer:Webide - Revision history

Akuzmin: minor fixes

2025-11-18T11:26:23Z

minor fixes

← Older revision		Revision as of 14:26, 18 November 2025
Line 20:		Line 20:
	=== Запуск функциональности при использовании docker compose ===		=== Запуск функциональности при использовании docker compose ===

	В случае запуска Svacer [[Help:Installation#docker_compose\|с помощью docker compose]], функциональность Webide будет активирована по умолчанию. При этом в docker-контейнер содержащий Svacer по умолчанию будет проброшен (примонтирован) unix-сокет файл <code style="white-space: pre;">/var/run/docker.sock</code>, доступ к которому будет использоваться для управления контейнерами c IDE. При запуске контейнеры с IDE будут подключаться к docker-сети <code>svacer</code>, которая будет создана при вызове <code>docker compose up</code>.		В случае запуска Svacer [[Help:Installation#docker_compose\|с помощью docker compose]], функциональность Webide будет активирована по умолчанию. При этом в docker-контейнер, содержащий Svacer, по умолчанию будет проброшен (примонтирован) unix-сокет файл <code style="white-space: pre;">/var/run/docker.sock</code>, доступ к которому будет использоваться для управления контейнерами c IDE. При запуске контейнеры с IDE будут подключаться к docker-сети <code>svacer</code>, которая будет создана при вызове <code>docker compose up</code>.

	=== Запуск функциональности в Svacer с настройками по умолчанию ===		=== Запуск функциональности в Svacer с настройками по умолчанию ===

M.vinogradov: start IDE from Svacer in docker container

2025-11-14T14:38:32Z

start IDE from Svacer in docker container

Show changes

M.vinogradov: Релиз 11. Удалена настройка шаблона комментария sarif/commenttemplate

2025-05-20T07:53:16Z

Релиз 11. Удалена настройка шаблона комментария sarif/commenttemplate

← Older revision		Revision as of 10:53, 20 May 2025
Line 26:		Line 26:
	# Перезапустить Svacer с флагом <code style="white-space: pre;">--xsvacer.features webide</code>		# Перезапустить Svacer с флагом <code style="white-space: pre;">--xsvacer.features webide</code>
	# ''Опционально.'' Для ускорения первого запуска IDE:		# ''Опционально.'' Для ускорения первого запуска IDE:
	## Скачать архив с docker-образом для соответствующей версии Svacer: [https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz 10+], [https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar 9+]		## Скачать архив с docker-образом для соответствующей версии Svacer: [https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.11.0.0.1.tar.gz 11+], [https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz 10+], [https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar 9+]
	## Загрузить docker-образ из архива на docker-хост: <code style="white-space: pre;">docker image load -i /path/to/theia-blueprint...</code>		## Загрузить docker-образ из архива на docker-хост: <code style="white-space: pre;">docker image load -i /path/to/theia-blueprint...</code>

Line 378:		Line 378:
	\|sarif/commenttemplate		\|sarif/commenttemplate
	\|golang template string		\|golang template string
	\|Шаблон для формирования элемента списка комментариев предупреждения при экспорте в sarif-файл. В шаблон передаётся структура [[Help:XSvacer:Webide#Структуры_передаваемые_в_поля_с_golang-шаблонами_строк\|Comment]]		\|{{Note\|text=Удалён в версии 11.0.0}}
			Шаблон для формирования элемента списка комментариев предупреждения при экспорте в sarif-файл. В шаблон передаётся структура [[Help:XSvacer:Webide#Структуры_передаваемые_в_поля_с_golang-шаблонами_строк\|Comment]]
	\|<nowiki>"{{if trim .Text}}`[{{.CreateTs.Local.Format \"02.01.2006 15:04\"}}] {{.CreatedBy}}:`\n\n{{trim .Text}}{{end}}"</nowiki>		\|<nowiki>"{{if trim .Text}}`[{{.CreateTs.Local.Format \"02.01.2006 15:04\"}}] {{.CreatedBy}}:`\n\n{{trim .Text}}{{end}}"</nowiki>
	\|}		\|}
Line 449:		Line 450:
	\|string		\|string
	\|Тег образа		\|Тег образа
	\|Svacer 10+: 1.46.0.sarif.clang.10.0.0		\|Svacer 11+: 1.46.0.sarif.clang.11.0.0.1
			Svacer 10+: 1.46.0.sarif.clang.10.0.0

	Svacer 9+: 1.46.0.sarif.clang		Svacer 9+: 1.46.0.sarif.clang
	\|-		\|-
Line 465:		Line 468:
	* путь к локальному файлу: схема <code>file://</code>		* путь к локальному файлу: схема <code>file://</code>
	* http/https-адрес: схема <code>http://</code> или <code>https://</code>		* http/https-адрес: схема <code>http://</code> или <code>https://</code>
	\|Svacer 10+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz		\|Svacer 11+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.11.0.0.1.tar.gz
			Svacer 10+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz

	Svacer 9+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar		Svacer 9+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar
	\|-		\|-
Line 607:		Line 612:
	sarif:		sarif:
	filenametemplate: "warnings.sarif"		filenametemplate: "warnings.sarif"
	~~commenttemplate: "{{if trim .Text}}`[{{.CreateTs.Local.Format \"02.01.2006 15:04\"}}] {{.CreatedBy}}:`\n\n{{trim .Text}}{{end}}"~~
	manager:		manager:
	type: default		type: default
Line 615:		Line 619:
	image:		image:
	name: theia-blueprint		name: theia-blueprint
	tag: 1.46.0.sarif.clang.10.0.0		tag: 1.46.0.sarif.clang.11.0.0.1
	sourcetype: file		sourcetype: file
	sourcefileurl: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz		sourcefileurl: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.11.0.0.1.tar.gz
	containerconfiglabels:		containerconfiglabels:
	- "com.docker.compose.project": svacer		- "com.docker.compose.project": svacer
Line 677:		Line 681:

	Содержит значение		Содержит значение

			Svacer 11+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.11.0.0.1.tar.gz
	Svacer 10+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz		Svacer 10+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.10.0.0.tar.gz
	Svacer 9+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar		Svacer 9+: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar

Akuzmin: minor fixes

2025-01-16T15:15:11Z

minor fixes

← Older revision		Revision as of 18:15, 16 January 2025
Line 357:		Line 357:
	==== Параметры экспорта sarif-файла с разметкой предупреждений ====		==== Параметры экспорта sarif-файла с разметкой предупреждений ====

	Данные параметры используются для настройки экспорта sarif-файлов с разметкой предупреждений, выполненной в Svacer'е.		Данные параметры используются для настройки экспорта sarif-файлов с разметкой предупреждений, выполненной в Svacer.

	{\| class="wikitable"		{\| class="wikitable"

M.vinogradov at 08:29, 15 January 2025

2025-01-15T08:29:13Z

Show changes

M.vinogradov at 07:51, 14 January 2025

2025-01-14T07:51:11Z

← Older revision		Revision as of 10:51, 14 January 2025
Line 71:		Line 71:
	# Создаётся "корневая папка снимка", предназначенная для хранения исходного кода снимка и предупреждений анализатора с разметкой в виде sarif-файла. Название папки соответствует id снимка. Папка создаётся по пути заданному в параметре конфигурации IDE <code>xsvacer/webide/theia/{идентификатор конфигурации}/sourcesroot</code>		# Создаётся "корневая папка снимка", предназначенная для хранения исходного кода снимка и предупреждений анализатора с разметкой в виде sarif-файла. Название папки соответствует id снимка. Папка создаётся по пути заданному в параметре конфигурации IDE <code>xsvacer/webide/theia/{идентификатор конфигурации}/sourcesroot</code>
	# Исходный код снимка скачивается в "корневую папку снимка"		# Исходный код снимка скачивается в "корневую папку снимка"
	# Производится экспорт маркеров и разметки в виде sarif-файла в "корневую папку снимка". Название sarif-файла формируется с помощью шаблона, заданного в параметре конфигурации IDE <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/~~sariffiletemplate~~</code>		# Производится экспорт маркеров и разметки в виде sarif-файла в "корневую папку снимка". Название sarif-файла формируется с помощью шаблона, заданного в параметре конфигурации IDE <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/sarif/filenametemplate</code>
	# Производится настройка и запуск docker-контейнера в соответствии с настройками <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/docker</code>:		# Производится настройка и запуск docker-контейнера в соответствии с настройками <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/docker</code>:
	## Проверяется наличие на docker-хосте образа IDE, указанного в <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/docker/image</code>. Если docker-образ отсутствует, он будет загружен на хост		## Проверяется наличие на docker-хосте образа IDE, указанного в <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/docker/image</code>. Если docker-образ отсутствует, он будет загружен на хост
Line 350:		Line 350:
	\|sariffiletemplate		\|sariffiletemplate
	\|golang template string		\|golang template string
	\|Шаблон названия sarif-файла с предупреждениями анализатора. В шаблон передаётся структура [[Help:XSvacer:Webide#Структуры_передаваемые_в_поля_с_golang-шаблонами_строк\|sarifFileContext]]		\|{{Note\|text=В версии 10.0.0 заменён на [[Help:XSvacer:Webide#Параметры_экспорта_sarif-файла_с_разметкой_предупреждений\|sarif]]}}
			Шаблон названия sarif-файла с предупреждениями анализатора. В шаблон передаётся структура [[Help:XSvacer:Webide#Структуры_передаваемые_в_поля_с_golang-шаблонами_строк\|sarifFileContext]]
	\|<nowiki>"{{.Context.ProjectName}}.{{.Context.BranchName}}.sarif"</nowiki>		\|<nowiki>"{{.Context.ProjectName}}.{{.Context.BranchName}}.sarif"</nowiki>
			\|}

			==== Параметры экспорта sarif-файла с разметкой предупреждений ====

			Данные параметры используются для настройки экспорта sarif-файлов с разметкой предупреждений, выполненной в Svacer'е.

			{\| class="wikitable"
			\|+
			!Название
			!Тип данных
			!Описание
			!Значение в конфигурации по умолчанию
			\|-
			\|sarif
			\|map
			\|Настройки экспорта sarif-файла
			\|
			\|-
			\|sarif/filenametemplate
			\|golang template string
			\|Шаблон для формирования названия sarif-файла. В шаблон передаётся структура [[Help:XSvacer:Webide#Структуры_передаваемые_в_поля_с_golang-шаблонами_строк\|sarifFileContext]]
			\|<nowiki>"warnings.sarif"</nowiki>
			\|-
			\|sarif/commenttemplate
			\|golang template string
			\|Шаблон для формирования элемента списка комментариев предупреждения при экспорте в sarif-файл. В шаблон передаётся структура [[Help:XSvacer:Webide#Структуры_передаваемые_в_поля_с_golang-шаблонами_строк\|Comment]]
			\|<nowiki>"{{if trim .Text}}`[{{.CreateTs.Local.Format \"02.01.2006 15:04\"}}] {{.CreatedBy}}:`\n\n{{trim .Text}}{{end}}"</nowiki>
	\|}		\|}

Line 508:		Line 536:
	sarifFileContext {		sarifFileContext {
	Time time.Time		Time time.Time
	Context: {		Context: {
	ProjectID *string		ProjectID *string
	BranchID *string		BranchID *string
	SnapshotID *string		SnapshotID *string
	MarkerID *string		MarkerID *string

	ProjectName *string		ProjectName *string
	BranchName *string		BranchName *string
Line 523:		Line 551:
	}		}
	}		}

	TheiaDockerContainerStartContext {		TheiaDockerContainerStartContext {
	IdeID: {		IdeID: {
	IdeType string		IdeType string
	ConfigID string		ConfigID string
	},		},
	StartArgs: {		StartArgs: {
	SnapshotID string		SnapshotID string
	UserID string		UserID string
	User string		User string
	},		},
	Context: {		Context: {
	ProjectID *string		ProjectID *string
	BranchID *string		BranchID *string
Line 548:		Line 576:
	CreateTs null.Time		CreateTs null.Time
	}		}
			}

			Comment {
			ID string
			Text string
			Ref string
			CreatedBy string
			CreatedByID string
			CreateTs time.Time
			UpdateTs *time.Time
			UpdatedBy string
			UpdatedByID string
	}		}

Line 563:		Line 603:
	name: Theia blueprint web IDE (v1.46.0)		name: Theia blueprint web IDE (v1.46.0)
	sourcesroot: ${USER_CACHE_DIR}/svacer-snapshot-sources		sourcesroot: ${USER_CACHE_DIR}/svacer-snapshot-sources
	~~sariffiletemplate~~: "~~<nowiki>~~{{.~~Context~~.~~ProjectName~~}}.{{.~~Context.BranchName~~}}~~</nowiki>.sarif~~"		sarif:
			filenametemplate: "warnings.sarif"
			commenttemplate: "{{if trim .Text}}`[{{.CreateTs.Local.Format \"02.01.2006 15:04\"}}] {{.CreatedBy}}:`\n\n{{trim .Text}}{{end}}"
	manager:		manager:
	type: default		type: default

M.vinogradov at 11:53, 15 July 2024

2024-07-15T11:53:47Z

← Older revision		Revision as of 14:53, 15 July 2024
Line 143:		Line 143:
	XSVACER_WEBIDE_THEIA_DEFAULT_DOCKER_CONTAINER_HOSTCONFIG_AUTOREMOVE=false		XSVACER_WEBIDE_THEIA_DEFAULT_DOCKER_CONTAINER_HOSTCONFIG_AUTOREMOVE=false

	{{Note\|type=error\|text=При использовании версии Svacer 9-0-0 установка <code>autoremove: false</code> вызывает ошибку запуска. Исправлено в версии [[Svacer#Релизы\|9-0-1]].'''}}		{{Note\|type=error\|text=При использовании версии Svacer 9.0.0 установка <code>autoremove: false</code> вызывает ошибку запуска. Исправлено в версии [[Svacer#Релизы\|9.0.1]].'''}}

	При корректной остановке (например SIGTERM) Svacer автоматически остановит все запущенные docker-контейнеры IDE.		При корректной остановке (например SIGTERM) Svacer автоматически остановит все запущенные docker-контейнеры IDE.

M.vinogradov at 11:52, 15 July 2024

2024-07-15T11:52:57Z

← Older revision		Revision as of 14:52, 15 July 2024
Line 143:		Line 143:
	XSVACER_WEBIDE_THEIA_DEFAULT_DOCKER_CONTAINER_HOSTCONFIG_AUTOREMOVE=false		XSVACER_WEBIDE_THEIA_DEFAULT_DOCKER_CONTAINER_HOSTCONFIG_AUTOREMOVE=false

	{{Note\|type=error\|text=~~Сейчас~~ установка <code>autoremove: false</code> вызывает ошибку запуска Svacer. ~~Не используйте данную настройку до исправления~~'''}}		{{Note\|type=error\|text=При использовании версии Svacer 9-0-0 установка <code>autoremove: false</code> вызывает ошибку запуска. Исправлено в версии [[Svacer#Релизы\|9-0-1]].'''}}

	При корректной остановке (например SIGTERM) Svacer автоматически остановит все запущенные docker-контейнеры IDE.		При корректной остановке (например SIGTERM) Svacer автоматически остановит все запущенные docker-контейнеры IDE.

Akuzmin: change to info/warning blocks

2024-06-19T13:03:46Z

change to info/warning blocks

M.vinogradov: support#3391 docker image url changed

2024-06-19T09:13:17Z

support#3391 docker image url changed

← Older revision		Revision as of 12:13, 19 June 2024
Line 26:		Line 26:
	# Перезапустить Svacer с флагом <code style="white-space: pre;">--xsvacer.features webide</code>		# Перезапустить Svacer с флагом <code style="white-space: pre;">--xsvacer.features webide</code>
	# ''Опционально.'' Для ускорения первого запуска IDE:		# ''Опционально.'' Для ускорения первого запуска IDE:
	## Скачать [https://~~nextcloud~~.ispras.ru/~~index.php/s/gr7pa4RDJBBqAPy~~/~~download~~/theia-blueprint.1.46.0.sarif.clang.tar архив с docker-образом]		## Скачать [https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar архив с docker-образом]
	## Загрузить docker-образ из архива на docker-хост: <code style="white-space: pre;">docker image load -i /path/to/theia-blueprint.1.46.0.sarif.clang.tar</code>		## Загрузить docker-образ из архива на docker-хост: <code style="white-space: pre;">docker image load -i /path/to/theia-blueprint.1.46.0.sarif.clang.tar</code>

Line 436:		Line 436:
	* путь к локальному файлу: схема <code>file://</code>		* путь к локальному файлу: схема <code>file://</code>
	* http/https-адрес: схема <code>http://</code> или <code>https://</code>		* http/https-адрес: схема <code>http://</code> или <code>https://</code>
	\|https://~~nextcloud~~.ispras.ru/~~index.php/s/gr7pa4RDJBBqAPy~~/~~download~~/theia-blueprint.1.46.0.sarif.clang.tar		\|https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar
	\|-		\|-
	\|docker/container/		\|docker/container/
Line 573:		Line 573:
	tag: 1.46.0.sarif.clang		tag: 1.46.0.sarif.clang
	sourcetype: file		sourcetype: file
	sourcefileurl: https://~~nextcloud~~.ispras.ru/~~index.php/s/gr7pa4RDJBBqAPy~~/~~download~~/theia-blueprint.1.46.0.sarif.clang.tar		sourcefileurl: https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar
	containerconfiglabels:		containerconfiglabels:
	- "com.docker.compose.project": svacer		- "com.docker.compose.project": svacer
Line 634:		Line 634:
	Содержит значение		Содержит значение

	https://~~nextcloud~~.ispras.ru/~~index.php/s/gr7pa4RDJBBqAPy~~/~~download~~/theia-blueprint.1.46.0.sarif.clang.tar		https://svacer.ispras.ru/docker/images/theia-blueprint.1.46.0.sarif.clang.tar

	По этому адресу находится архив с docker-образом для Theia IDE.		По этому адресу находится архив с docker-образом для Theia IDE.

← Older revision		Revision as of 16:03, 19 June 2024
Line 1:		Line 1:
			{{Note\|text=Данная функциональность входит в набор расширений XSvacer}}

	= Поддержка среды разработки Theia IDE =		= Поддержка среды разработки Theia IDE =

	~~Данная функциональность входит в набор расширений XSvacer~~

	Данная функциональность даёт возможность просматривать исходный код снимка с предупреждениями анализатора во внешней IDE.		Данная функциональность даёт возможность просматривать исходный код снимка с предупреждениями анализатора во внешней IDE.
Line 31:		Line 31:
	После этого у пользователей с указанными правами должна появиться кнопка "Открыть в IDE" на панели с информацией о снимке.		После этого у пользователей с указанными правами должна появиться кнопка "Открыть в IDE" на панели с информацией о снимке.

	~~'''Внимание!'''~~ IDE с исходным кодом снимков будут запускаться в новых вкладках браузера. Обычно все браузеры блокируют автоматическое открытие вкладки и показывают соответствующее предупреждение.		{{Note}} IDE с исходным кодом снимков будут запускаться в новых вкладках браузера. Обычно все браузеры блокируют автоматическое открытие вкладки и показывают соответствующее предупреждение.

	Например, в Firefox:		Например, в Firefox:
Line 86:		Line 86:
	При возникновении ошибки на одном из этапов запуска IDE артефакты, созданные на предыдущих этапах, останутся в системе. В дальнейшем они могут быть использованы при повторном запуске IDE, если причина возникновения ошибки была устранена.		При возникновении ошибки на одном из этапов запуска IDE артефакты, созданные на предыдущих этапах, останутся в системе. В дальнейшем они могут быть использованы при повторном запуске IDE, если причина возникновения ошибки была устранена.

	Причиной возникновения ошибки "ide not ready" может стать высокая загруженность или недостаточная производительность docker-хоста, на котором запускается контейнер с IDE. В связи с этим процесс IDE внутри контейнера может запускаться дольше, чем указано в настойках <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/healthcheck</code>. В этом случае рекомендуется попробовать повторно запустить IDE через короткий промежуток времени.		{{Note\|type=reminder\|text=Причиной возникновения ошибки "ide not ready" может стать высокая загруженность или недостаточная производительность docker-хоста, на котором запускается контейнер с IDE. В связи с этим процесс IDE внутри контейнера может запускаться дольше, чем указано в настойках <code style="white-space: pre;">xsvacer/webide/theia/{идентификатор конфигурации}/healthcheck</code>. В этом случае рекомендуется попробовать повторно запустить IDE через короткий промежуток времени}}

	Ещё одной причиной возникновения данной ошибки может стать сетевая недоступность docker-контейнера при подключении к удалённому docker-хосту. В таком случае рекомендуется проверить:		Ещё одной причиной возникновения данной ошибки может стать сетевая недоступность docker-контейнера при подключении к удалённому docker-хосту. В таком случае рекомендуется проверить:
Line 108:		Line 108:
	Для запуска IDE в окне браузера нужно указать адрес		Для запуска IDE в окне браузера нужно указать адрес

	<code style="white-space: pre;"><nowiki>http[s]://svacer-host/xvacer/webide/snapshots/{snapshot_id}/{ide_id}/</nowiki></code>		:<code style="white-space: pre;"><nowiki>http[s]://svacer-host/xvacer/webide/snapshots/{snapshot_id}/{ide_id}/</nowiki></code>

	~~'''~~Завершающий слеш обязателен!~~'''~~		{{Note}} Завершающий слеш обязателен!

	=== Перезапуск IDE ===		=== Перезапуск IDE ===
Line 143:		Line 143:
	XSVACER_WEBIDE_THEIA_DEFAULT_DOCKER_CONTAINER_HOSTCONFIG_AUTOREMOVE=false		XSVACER_WEBIDE_THEIA_DEFAULT_DOCKER_CONTAINER_HOSTCONFIG_AUTOREMOVE=false

	~~'''~~Сейчас установка <code>autoremove: false</code> вызывает ошибку запуска Svacer. Не используйте данную настройку до исправления.'''		{{Note\|type=error\|text=Сейчас установка <code>autoremove: false</code> вызывает ошибку запуска Svacer. Не используйте данную настройку до исправления'''}}

	При корректной остановке (например SIGTERM) Svacer автоматически остановит все запущенные docker-контейнеры IDE.		При корректной остановке (например SIGTERM) Svacer автоматически остановит все запущенные docker-контейнеры IDE.
Line 153:		Line 153:
	== REST API для работы с IDE ==		== REST API для работы с IDE ==

	~~'''Внимание!'''~~ На этапе внедрения расширений XSvacer REST API может меняться. Следите за анонсами!		{{Note\|text=На этапе внедрения расширений XSvacer REST API может меняться. Следите за анонсами!}}

	После активации функциональности становятся доступны http-ресурсы для управления IDE:		После активации функциональности становятся доступны http-ресурсы для управления IDE:
Line 298:		Line 298:
	=== Конфигурация запуска Theia IDE ===		=== Конфигурация запуска Theia IDE ===

	~~'''Внимание!'''~~ На этапе внедрения расширений XSvacer конфигурация функциональностей может меняться. Следите за анонсами!		{{Note\|text=На этапе внедрения расширений XSvacer конфигурация функциональностей может меняться. Следите за анонсами!}}

	Конфигурации запуска Theia IDE добавляются в виде полей в разделе <code style="white-space: pre;">xsvacer/webide</code>. Название поля является идентификатором конфигурации запуска. Например, идентификатор по номеру используемой версии IDE:		Конфигурации запуска Theia IDE добавляются в виде полей в разделе <code style="white-space: pre;">xsvacer/webide</code>. Название поля является идентификатором конфигурации запуска. Например, идентификатор по номеру используемой версии IDE:
Line 597:		Line 597:
	По умолчанию используется docker-хост с идентификатором <code>default</code>. Согласно настройке этого хоста, по умолчанию предполагается взаимодействие с докером через unix-сокет <code style="white-space: pre;">unix:///var/run/docker.sock</code>. Соответственно пользователь, под которым запускается Svacer, должен иметь доступ к этому сокету (https://docs.docker.com/engine/install/linux-postinstall/).		По умолчанию используется docker-хост с идентификатором <code>default</code>. Согласно настройке этого хоста, по умолчанию предполагается взаимодействие с докером через unix-сокет <code style="white-space: pre;">unix:///var/run/docker.sock</code>. Соответственно пользователь, под которым запускается Svacer, должен иметь доступ к этому сокету (https://docs.docker.com/engine/install/linux-postinstall/).

	При наличии раздела <code style="white-space: pre;">xsvacer/webide</code> в конфигурационном файле svacer.cfg будут применены только настройки из этого раздела. Настройки по умолчанию будут полностью проигнорированы.		{{Note\|text=При наличии раздела <code style="white-space: pre;">xsvacer/webide</code> в конфигурационном файле svacer.cfg будут применены только настройки из этого раздела. Настройки по умолчанию будут полностью проигнорированы}}

	=== Изменение конфигурационных параметров с помощью переменных окружения ===		=== Изменение конфигурационных параметров с помощью переменных окружения ===