@alfalab/arui-scripts-artifacts 0.0.0-beta-20260824133302
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.eslintignore +2 -0
- package/.eslintrc.js +8 -0
- package/.prettierignore +2 -0
- package/.turbo/turbo-build.log +0 -0
- package/.turbo/turbo-test.log +15 -0
- package/CHANGELOG.md +42 -0
- package/README.md +298 -0
- package/build/archive/build-archive.d.ts +14 -0
- package/build/archive/build-archive.js +69 -0
- package/build/archive/constants.d.ts +6 -0
- package/build/archive/constants.js +6 -0
- package/build/archive/index.d.ts +2 -0
- package/build/archive/index.js +2 -0
- package/build/cjs/archive/build-archive.d.ts +14 -0
- package/build/cjs/archive/build-archive.js +75 -0
- package/build/cjs/archive/constants.d.ts +6 -0
- package/build/cjs/archive/constants.js +9 -0
- package/build/cjs/archive/index.d.ts +2 -0
- package/build/cjs/archive/index.js +9 -0
- package/build/cjs/bin/index.d.ts +2 -0
- package/build/cjs/bin/index.js +58 -0
- package/build/cjs/cli/config-file.d.ts +46 -0
- package/build/cjs/cli/config-file.js +117 -0
- package/build/cjs/cli/create-cli.d.ts +25 -0
- package/build/cjs/cli/create-cli.js +75 -0
- package/build/cjs/cli/index.d.ts +3 -0
- package/build/cjs/cli/index.js +17 -0
- package/build/cjs/cli/load-config-file.d.ts +15 -0
- package/build/cjs/cli/load-config-file.js +62 -0
- package/build/cjs/config/index.d.ts +10 -0
- package/build/cjs/config/index.js +132 -0
- package/build/cjs/config/types.d.ts +226 -0
- package/build/cjs/config/types.js +2 -0
- package/build/cjs/docker/build-command.d.ts +13 -0
- package/build/cjs/docker/build-command.js +65 -0
- package/build/cjs/docker/build-docker-image.d.ts +21 -0
- package/build/cjs/docker/build-docker-image.js +65 -0
- package/build/cjs/docker/build-params.d.ts +20 -0
- package/build/cjs/docker/build-params.js +52 -0
- package/build/cjs/docker/constants.d.ts +19 -0
- package/build/cjs/docker/constants.js +22 -0
- package/build/cjs/docker/index.d.ts +7 -0
- package/build/cjs/docker/index.js +26 -0
- package/build/cjs/docker/prepare-files.d.ts +19 -0
- package/build/cjs/docker/prepare-files.js +81 -0
- package/build/cjs/docker/templates/dockerfile-compiled.template.d.ts +6 -0
- package/build/cjs/docker/templates/dockerfile-compiled.template.js +52 -0
- package/build/cjs/docker/templates/dockerfile.template.d.ts +5 -0
- package/build/cjs/docker/templates/dockerfile.template.js +46 -0
- package/build/cjs/index.d.ts +15 -0
- package/build/cjs/index.js +45 -0
- package/build/cjs/nginx/constants.d.ts +11 -0
- package/build/cjs/nginx/constants.js +19 -0
- package/build/cjs/nginx/index.d.ts +3 -0
- package/build/cjs/nginx/index.js +13 -0
- package/build/cjs/nginx/templates/base-nginx.conf.template.d.ts +7 -0
- package/build/cjs/nginx/templates/base-nginx.conf.template.js +57 -0
- package/build/cjs/nginx/templates/nginx.conf.template.d.ts +5 -0
- package/build/cjs/nginx/templates/nginx.conf.template.js +52 -0
- package/build/cjs/pipeline/build-artifact.d.ts +8 -0
- package/build/cjs/pipeline/build-artifact.js +16 -0
- package/build/cjs/pipeline/host-pipeline.d.ts +9 -0
- package/build/cjs/pipeline/host-pipeline.js +33 -0
- package/build/cjs/pipeline/index.d.ts +3 -0
- package/build/cjs/pipeline/index.js +9 -0
- package/build/cjs/pipeline/render.d.ts +16 -0
- package/build/cjs/pipeline/render.js +38 -0
- package/build/cjs/start-script/constants.d.ts +4 -0
- package/build/cjs/start-script/constants.js +7 -0
- package/build/cjs/start-script/index.d.ts +2 -0
- package/build/cjs/start-script/index.js +8 -0
- package/build/cjs/start-script/start.template.d.ts +6 -0
- package/build/cjs/start-script/start.template.js +74 -0
- package/build/cjs/utils/exec.d.ts +12 -0
- package/build/cjs/utils/exec.js +36 -0
- package/build/cjs/utils/shell.d.ts +6 -0
- package/build/cjs/utils/shell.js +16 -0
- package/build/cjs/utils/yarn.d.ts +25 -0
- package/build/cjs/utils/yarn.js +70 -0
- package/build/cli/config-file.d.ts +46 -0
- package/build/cli/config-file.js +110 -0
- package/build/cli/create-cli.d.ts +25 -0
- package/build/cli/create-cli.js +71 -0
- package/build/cli/index.d.ts +3 -0
- package/build/cli/index.js +3 -0
- package/build/cli/load-config-file.d.ts +15 -0
- package/build/cli/load-config-file.js +53 -0
- package/build/config/index.d.ts +10 -0
- package/build/config/index.js +126 -0
- package/build/config/types.d.ts +226 -0
- package/build/config/types.js +1 -0
- package/build/docker/build-command.d.ts +13 -0
- package/build/docker/build-command.js +57 -0
- package/build/docker/build-docker-image.d.ts +21 -0
- package/build/docker/build-docker-image.js +59 -0
- package/build/docker/build-params.d.ts +20 -0
- package/build/docker/build-params.js +44 -0
- package/build/docker/constants.d.ts +19 -0
- package/build/docker/constants.js +19 -0
- package/build/docker/index.d.ts +7 -0
- package/build/docker/index.js +7 -0
- package/build/docker/prepare-files.d.ts +19 -0
- package/build/docker/prepare-files.js +75 -0
- package/build/docker/templates/dockerfile-compiled.template.d.ts +6 -0
- package/build/docker/templates/dockerfile-compiled.template.js +49 -0
- package/build/docker/templates/dockerfile.template.d.ts +5 -0
- package/build/docker/templates/dockerfile.template.js +43 -0
- package/build/index.d.ts +15 -0
- package/build/index.js +20 -0
- package/build/nginx/constants.d.ts +11 -0
- package/build/nginx/constants.js +16 -0
- package/build/nginx/index.d.ts +3 -0
- package/build/nginx/index.js +3 -0
- package/build/nginx/templates/base-nginx.conf.template.d.ts +7 -0
- package/build/nginx/templates/base-nginx.conf.template.js +54 -0
- package/build/nginx/templates/nginx.conf.template.d.ts +5 -0
- package/build/nginx/templates/nginx.conf.template.js +49 -0
- package/build/pipeline/build-artifact.d.ts +8 -0
- package/build/pipeline/build-artifact.js +13 -0
- package/build/pipeline/host-pipeline.d.ts +9 -0
- package/build/pipeline/host-pipeline.js +27 -0
- package/build/pipeline/index.d.ts +3 -0
- package/build/pipeline/index.js +3 -0
- package/build/pipeline/render.d.ts +16 -0
- package/build/pipeline/render.js +35 -0
- package/build/start-script/constants.d.ts +4 -0
- package/build/start-script/constants.js +4 -0
- package/build/start-script/index.d.ts +2 -0
- package/build/start-script/index.js +2 -0
- package/build/start-script/start.template.d.ts +6 -0
- package/build/start-script/start.template.js +71 -0
- package/build/utils/exec.d.ts +12 -0
- package/build/utils/exec.js +28 -0
- package/build/utils/shell.d.ts +6 -0
- package/build/utils/shell.js +13 -0
- package/build/utils/yarn.d.ts +25 -0
- package/build/utils/yarn.js +61 -0
- package/jest.config.js +12 -0
- package/package.json +57 -0
- package/tsconfig.cjs.json +13 -0
- package/tsconfig.eslint.json +7 -0
- package/tsconfig.json +22 -0
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
export type YarnVersion = '1' | '2+' | 'unavailable';
|
|
2
|
+
/**
|
|
3
|
+
* Управление флагом `--platform` в команде `docker build`:
|
|
4
|
+
* - `'auto'` — историческое поведение: флаг подставляется только если версия docker его поддерживает;
|
|
5
|
+
* - `false` — никогда не добавлять флаг;
|
|
6
|
+
* - строка (например `'linux/amd64'`) — всегда использовать указанную платформу.
|
|
7
|
+
*/
|
|
8
|
+
export type DockerPlatform = 'auto' | false | string;
|
|
9
|
+
/** Вариант Dockerfile: «сырой» (сборка на хосте) или compiled (сборка внутри образа). */
|
|
10
|
+
export type DockerfileVariant = 'runtime' | 'compiled';
|
|
11
|
+
/** Тип собираемого артефакта поставки. */
|
|
12
|
+
export type ArtifactKind = 'docker' | 'archive';
|
|
13
|
+
/** Настройки docker-образа. Не используются при `artifact: 'archive'`. */
|
|
14
|
+
export type DockerOptions = {
|
|
15
|
+
/**
|
|
16
|
+
* Вариант сборки. `runtime` (по умолчанию) — приложение собирается на хосте и результат кладется
|
|
17
|
+
* в образ; `compiled` — зависимости и сборка выполняются внутри образа. От варианта зависят
|
|
18
|
+
* дефолты хост-пайплайна (см. {@link BuildOptions}).
|
|
19
|
+
*/
|
|
20
|
+
variant?: DockerfileVariant;
|
|
21
|
+
/** Docker registry, к которому будет добавлен образ (`registry/name:version`). */
|
|
22
|
+
registry?: string;
|
|
23
|
+
/** Базовый docker-образ (`FROM`). */
|
|
24
|
+
baseImage?: string;
|
|
25
|
+
/** Запускать ли процессы в образе от пользователя nginx (не root). */
|
|
26
|
+
runFromNonRootUser?: boolean;
|
|
27
|
+
/** Контекст сборки docker (последний аргумент `docker build`). */
|
|
28
|
+
context?: string;
|
|
29
|
+
/** Имя временной директории для сгенерированных файлов. */
|
|
30
|
+
tempDirName?: string;
|
|
31
|
+
/** Выполнять ли `docker push` после сборки. По умолчанию — да, кроме `debug`. */
|
|
32
|
+
push?: boolean;
|
|
33
|
+
/** Управление флагом `--platform`. */
|
|
34
|
+
platform?: DockerPlatform;
|
|
35
|
+
/** Дополнительные `--build-arg` для `docker build`. */
|
|
36
|
+
buildArgs?: Record<string, string>;
|
|
37
|
+
/** Добавлять ли `node_modules` в `.dockerignore` (нужно для compiled-образа). */
|
|
38
|
+
addNodeModulesToDockerIgnore?: boolean;
|
|
39
|
+
};
|
|
40
|
+
/** Настройки базового nginx-конфига (http-блок, `/etc/nginx/nginx.conf`). */
|
|
41
|
+
export type NginxBaseConfOptions = {
|
|
42
|
+
workerProcesses?: number;
|
|
43
|
+
workerRlimitNoFile?: number;
|
|
44
|
+
workerConnections?: number;
|
|
45
|
+
eventsUse?: string;
|
|
46
|
+
daemon?: string;
|
|
47
|
+
};
|
|
48
|
+
/** Настройки nginx: и server-блока, который генерируется всегда, и базового http-блока. */
|
|
49
|
+
export type NginxOptions = {
|
|
50
|
+
/** Порт, который слушает nginx внутри контейнера. */
|
|
51
|
+
port?: number;
|
|
52
|
+
/** Корень, из которого nginx раздает статику. */
|
|
53
|
+
rootPath?: string;
|
|
54
|
+
/** Добавлять ли заголовки для предыдущей версии словаря brotli. */
|
|
55
|
+
enablePreviousVersionHeaders?: boolean;
|
|
56
|
+
/**
|
|
57
|
+
* Базовый конфиг (http-блок). `null`/`false` (по умолчанию) — не генерировать и не класть в
|
|
58
|
+
* образ: используется тот, что лежит в базовом образе.
|
|
59
|
+
*/
|
|
60
|
+
baseConf?: NginxBaseConfOptions | null | false;
|
|
61
|
+
};
|
|
62
|
+
/** Настройки tar-архива. Не используются при `artifact: 'docker'`. */
|
|
63
|
+
export type ArchiveOptions = {
|
|
64
|
+
/** Имя итогового tar-архива. */
|
|
65
|
+
name?: string;
|
|
66
|
+
/** Имя временной директории, в которой собирается содержимое архива. */
|
|
67
|
+
tempDirName?: string;
|
|
68
|
+
/** Дополнительные директории проекта, которые кладутся в архив рядом со сборкой. */
|
|
69
|
+
additionalPaths?: string[];
|
|
70
|
+
};
|
|
71
|
+
/** Хост-пайплайн: что выполняется на машине сборки перед упаковкой артефакта. */
|
|
72
|
+
export type BuildOptions = {
|
|
73
|
+
/**
|
|
74
|
+
* Удалять ли `buildPath` перед сборкой приложения.
|
|
75
|
+
* По умолчанию — `true` для `runtime` и `false` для `compiled`.
|
|
76
|
+
*/
|
|
77
|
+
cleanBuildPath?: boolean;
|
|
78
|
+
/**
|
|
79
|
+
* Команда сборки приложения на хосте. `null`/`false` — не собирать.
|
|
80
|
+
* По умолчанию — `'npm run build'` для `runtime` и `null` для `compiled` (там сборка идет в образе).
|
|
81
|
+
*/
|
|
82
|
+
command?: string | null | false;
|
|
83
|
+
/**
|
|
84
|
+
* Удалять ли dev-зависимости ({@link PackageManagerOptions.pruneCommand}) перед упаковкой.
|
|
85
|
+
* По умолчанию — `true` для `runtime` и `false` для `compiled`.
|
|
86
|
+
*/
|
|
87
|
+
removeDevDependencies?: boolean;
|
|
88
|
+
};
|
|
89
|
+
/** Менеджер зависимостей: как ставить production-зависимости и как выкидывать dev-зависимости. */
|
|
90
|
+
export type PackageManagerOptions = {
|
|
91
|
+
/** Использовать ли yarn (если доступен). По умолчанию — по наличию `yarn.lock`. */
|
|
92
|
+
useYarn?: boolean;
|
|
93
|
+
/** Явно заданная версия yarn. По умолчанию определяется автоматически. */
|
|
94
|
+
yarnVersion?: YarnVersion;
|
|
95
|
+
/** Команда установки production-зависимостей внутри образа (для `compiled`). */
|
|
96
|
+
installProductionCommand?: string;
|
|
97
|
+
/** Команда очистки dev-зависимостей на хосте перед упаковкой артефакта. */
|
|
98
|
+
pruneCommand?: string;
|
|
99
|
+
};
|
|
100
|
+
/**
|
|
101
|
+
* Локальные файлы проекта, которые (если существуют и разрешены) используются вместо сгенерированных
|
|
102
|
+
* шаблонов.
|
|
103
|
+
*/
|
|
104
|
+
export type LocalFilesOptions = {
|
|
105
|
+
dockerfile?: string | null;
|
|
106
|
+
startScript?: string | null;
|
|
107
|
+
nginxConf?: string | null;
|
|
108
|
+
nginxBaseConf?: string | null;
|
|
109
|
+
/** Разрешить подмену Dockerfile локальным файлом. */
|
|
110
|
+
allowDockerfile?: boolean;
|
|
111
|
+
/** Разрешить подмену start.sh локальным файлом. */
|
|
112
|
+
allowStartScript?: boolean;
|
|
113
|
+
};
|
|
114
|
+
/**
|
|
115
|
+
* Функция-оверрайд шаблона. Получает сгенерированную по умолчанию строку и итоговый конфиг,
|
|
116
|
+
* возвращает новую строку. Позволяет точечно донасыщать/подменять любой из шаблонов.
|
|
117
|
+
*/
|
|
118
|
+
export type TemplateOverride = (generatedContent: string, config: ResolvedArtifactsConfig) => string;
|
|
119
|
+
/**
|
|
120
|
+
* Функция-рендерер шаблона. Полностью заменяет генерацию шаблона по умолчанию.
|
|
121
|
+
*/
|
|
122
|
+
export type TemplateRenderer = (config: ResolvedArtifactsConfig) => string;
|
|
123
|
+
export type TemplateKey = 'dockerfile' | 'dockerfileCompiled' | 'nginxConf' | 'baseNginxConf' | 'startScript';
|
|
124
|
+
/**
|
|
125
|
+
* Кастомные рендереры шаблонов. Любой из них можно переопределить целиком.
|
|
126
|
+
*/
|
|
127
|
+
export type ArtifactTemplates = Partial<Record<TemplateKey, TemplateRenderer>>;
|
|
128
|
+
/**
|
|
129
|
+
* Точечные оверрайды поверх сгенерированных по умолчанию шаблонов.
|
|
130
|
+
*/
|
|
131
|
+
export type ArtifactTemplateOverrides = Partial<Record<TemplateKey, TemplateOverride>>;
|
|
132
|
+
/**
|
|
133
|
+
* Готовые (отрендеренные) содержимые файлов, которые кладутся в артефакт.
|
|
134
|
+
*/
|
|
135
|
+
export type RenderedTemplates = {
|
|
136
|
+
dockerfile: string;
|
|
137
|
+
nginxConf: string;
|
|
138
|
+
nginxBaseConf: string;
|
|
139
|
+
startScript: string;
|
|
140
|
+
};
|
|
141
|
+
/**
|
|
142
|
+
* Полный набор опций сборки артефакта. Все поля опциональны — недостающие донасыщаются дефолтами
|
|
143
|
+
* в {@link resolveArtifactsConfig}. Это единственная точка входа для кастомизации: любой потребитель
|
|
144
|
+
* (arui-scripts, сторонние сборки, собственные скрипты) может собрать артефакт, передав сюда свои
|
|
145
|
+
* значения.
|
|
146
|
+
*
|
|
147
|
+
* Настройки сгруппированы по тому, к чему относятся: `docker`, `nginx`, `archive`, `build`,
|
|
148
|
+
* `packageManager`, `localFiles`. На верхнем уровне остается только то, что общее для всех
|
|
149
|
+
* артефактов, — идентификация и форма самого приложения.
|
|
150
|
+
*/
|
|
151
|
+
export type ArtifactsOptions = {
|
|
152
|
+
/**
|
|
153
|
+
* Что собирать: docker-образ (по умолчанию) или tar-архив с production-сборкой.
|
|
154
|
+
* Секция `docker` при `artifact: 'archive'` не используется, и наоборот.
|
|
155
|
+
*/
|
|
156
|
+
artifact?: ArtifactKind;
|
|
157
|
+
/** Имя артефакта (образа). По умолчанию берется из `package.json` в `cwd`. */
|
|
158
|
+
name?: string;
|
|
159
|
+
/** Версия/тег. По умолчанию берется из `package.json` в `cwd`. */
|
|
160
|
+
version?: string;
|
|
161
|
+
/** Рабочая директория проекта. */
|
|
162
|
+
cwd?: string;
|
|
163
|
+
/** Режим отладки: не пушить образ, печатать стек ошибок. */
|
|
164
|
+
debug?: boolean;
|
|
165
|
+
/** Собирается ли только клиентская часть (nginx без nodejs-сервера). */
|
|
166
|
+
clientOnly?: boolean;
|
|
167
|
+
/** Путь к директории со сборкой приложения относительно корня проекта. */
|
|
168
|
+
buildPath?: string;
|
|
169
|
+
/** Путь к серверному бандлу относительно `buildPath`. */
|
|
170
|
+
serverOutput?: string;
|
|
171
|
+
/** Порт, на котором поднимается nodejs-сервер приложения. */
|
|
172
|
+
serverPort?: number;
|
|
173
|
+
/** Директория со статикой внутри `buildPath`. Из нее выводится дефолт `publicPath`. */
|
|
174
|
+
assetsPath?: string;
|
|
175
|
+
/**
|
|
176
|
+
* Публичный префикс путей до статики — используется в `location` блоках nginx-конфига.
|
|
177
|
+
* По умолчанию `` `${assetsPath}/` ``, как это считает arui-scripts. Пустая строка приведет к
|
|
178
|
+
* дублирующемуся `location /` в nginx-конфиге, поэтому переопределять стоит осознанно.
|
|
179
|
+
*/
|
|
180
|
+
publicPath?: string;
|
|
181
|
+
docker?: DockerOptions;
|
|
182
|
+
nginx?: NginxOptions;
|
|
183
|
+
archive?: ArchiveOptions;
|
|
184
|
+
build?: BuildOptions;
|
|
185
|
+
packageManager?: PackageManagerOptions;
|
|
186
|
+
localFiles?: LocalFilesOptions;
|
|
187
|
+
/** Полная замена рендереров шаблонов. */
|
|
188
|
+
templates?: ArtifactTemplates;
|
|
189
|
+
/** Точечные оверрайды поверх сгенерированных шаблонов. */
|
|
190
|
+
overrides?: ArtifactTemplateOverrides;
|
|
191
|
+
};
|
|
192
|
+
export type ResolvedDockerConfig = Required<DockerOptions>;
|
|
193
|
+
export type ResolvedNginxBaseConf = Required<NginxBaseConfOptions>;
|
|
194
|
+
export type ResolvedNginxConfig = Required<Omit<NginxOptions, 'baseConf'>> & {
|
|
195
|
+
/** `null` — базовый конфиг не генерируется и не кладется в артефакт. */
|
|
196
|
+
baseConf: ResolvedNginxBaseConf | null;
|
|
197
|
+
};
|
|
198
|
+
export type ResolvedArchiveConfig = Required<ArchiveOptions>;
|
|
199
|
+
export type ResolvedBuildConfig = Required<Omit<BuildOptions, 'command'>> & {
|
|
200
|
+
command: string | null;
|
|
201
|
+
};
|
|
202
|
+
export type ResolvedPackageManagerConfig = Required<PackageManagerOptions>;
|
|
203
|
+
export type ResolvedLocalFilesConfig = Required<LocalFilesOptions>;
|
|
204
|
+
/**
|
|
205
|
+
* Полностью донасыщенный конфиг сборки. С ним работают все шаблоны и утилиты — они не знают ничего
|
|
206
|
+
* о том, откуда пришли значения, что делает их независимыми и легко тестируемыми.
|
|
207
|
+
*/
|
|
208
|
+
export type ResolvedArtifactsConfig = {
|
|
209
|
+
artifact: ArtifactKind;
|
|
210
|
+
name: string;
|
|
211
|
+
version: string;
|
|
212
|
+
cwd: string;
|
|
213
|
+
debug: boolean;
|
|
214
|
+
clientOnly: boolean;
|
|
215
|
+
buildPath: string;
|
|
216
|
+
serverOutput: string;
|
|
217
|
+
serverPort: number;
|
|
218
|
+
assetsPath: string;
|
|
219
|
+
publicPath: string;
|
|
220
|
+
docker: ResolvedDockerConfig;
|
|
221
|
+
nginx: ResolvedNginxConfig;
|
|
222
|
+
archive: ResolvedArchiveConfig;
|
|
223
|
+
build: ResolvedBuildConfig;
|
|
224
|
+
packageManager: ResolvedPackageManagerConfig;
|
|
225
|
+
localFiles: ResolvedLocalFilesConfig;
|
|
226
|
+
};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { type ResolvedArtifactsConfig } from '../config/types';
|
|
2
|
+
/**
|
|
3
|
+
* Проверяет, что версия docker (клиент и сервер) удовлетворяет semver-диапазону.
|
|
4
|
+
*/
|
|
5
|
+
export declare function dockerVersionSatisfies(request: string): boolean;
|
|
6
|
+
/**
|
|
7
|
+
* Вычисляет значение флага `--platform` согласно настройке `docker.platform` в конфиге.
|
|
8
|
+
*/
|
|
9
|
+
export declare function getPlatformFlag(config: ResolvedArtifactsConfig): string;
|
|
10
|
+
/**
|
|
11
|
+
* Формирует команду `docker build` для сгенерированной ранее временной директории.
|
|
12
|
+
*/
|
|
13
|
+
export declare function getDockerBuildCommand(config: ResolvedArtifactsConfig): string;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.dockerVersionSatisfies = dockerVersionSatisfies;
|
|
7
|
+
exports.getPlatformFlag = getPlatformFlag;
|
|
8
|
+
exports.getDockerBuildCommand = getDockerBuildCommand;
|
|
9
|
+
// именно default-импорт пакета целиком: semver — CommonJS без exports-карты, и Node ESM не умеет
|
|
10
|
+
// ни глубокий путь без расширения, ни именованные импорты из него
|
|
11
|
+
const semver_1 = __importDefault(require("semver"));
|
|
12
|
+
const shelljs_1 = __importDefault(require("shelljs"));
|
|
13
|
+
const constants_1 = require("../nginx/constants");
|
|
14
|
+
const constants_2 = require("../start-script/constants");
|
|
15
|
+
const shell_1 = require("../utils/shell");
|
|
16
|
+
const build_params_1 = require("./build-params");
|
|
17
|
+
const constants_3 = require("./constants");
|
|
18
|
+
/**
|
|
19
|
+
* Проверяет, что версия docker (клиент и сервер) удовлетворяет semver-диапазону.
|
|
20
|
+
*/
|
|
21
|
+
function dockerVersionSatisfies(request) {
|
|
22
|
+
const dockerServerVersion = shelljs_1.default.exec("docker version --format '{{.Server.Version}}'", {
|
|
23
|
+
silent: true,
|
|
24
|
+
});
|
|
25
|
+
const dockerClientVersion = shelljs_1.default.exec("docker version --format '{{.Client.Version}}'", {
|
|
26
|
+
silent: true,
|
|
27
|
+
});
|
|
28
|
+
return (semver_1.default.satisfies(dockerServerVersion.toString(), request) &&
|
|
29
|
+
semver_1.default.satisfies(dockerClientVersion.toString(), request));
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Вычисляет значение флага `--platform` согласно настройке `docker.platform` в конфиге.
|
|
33
|
+
*/
|
|
34
|
+
function getPlatformFlag(config) {
|
|
35
|
+
const { platform } = config.docker;
|
|
36
|
+
if (platform === 'auto') {
|
|
37
|
+
// на маках с m1 без флага docker пытается вытянуть базовый образ под свою платформу и падает,
|
|
38
|
+
// но сам флаг поддерживается без экспериментальных флагов только начиная с docker 20.10.21.
|
|
39
|
+
return dockerVersionSatisfies(constants_3.PLATFORM_FLAG_MIN_DOCKER_VERSION)
|
|
40
|
+
? `--platform ${constants_3.DEFAULT_PLATFORM}`
|
|
41
|
+
: '';
|
|
42
|
+
}
|
|
43
|
+
if (platform) {
|
|
44
|
+
return `--platform ${platform}`;
|
|
45
|
+
}
|
|
46
|
+
return '';
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Формирует команду `docker build` для сгенерированной ранее временной директории.
|
|
50
|
+
*/
|
|
51
|
+
function getDockerBuildCommand(config) {
|
|
52
|
+
const { tempDirName, context, buildArgs } = config.docker;
|
|
53
|
+
const { imageFullName } = (0, build_params_1.getBuildParams)(config);
|
|
54
|
+
const platformFlag = getPlatformFlag(config);
|
|
55
|
+
const extraArgs = Object.entries(buildArgs)
|
|
56
|
+
.map(([key, value]) => `--build-arg ${key}=${(0, shell_1.shellQuote)(value)}`)
|
|
57
|
+
.join(' ');
|
|
58
|
+
return `docker build ${platformFlag} \
|
|
59
|
+
-f ${(0, shell_1.shellQuote)(`./${tempDirName}/${constants_3.DOCKERFILE_FILENAME}`)} \
|
|
60
|
+
--build-arg START_SH_LOCATION=${(0, shell_1.shellQuote)(`./${tempDirName}/${constants_2.START_SCRIPT_FILENAME}`)} \
|
|
61
|
+
--build-arg NGINX_CONF_LOCATION=${(0, shell_1.shellQuote)(`./${tempDirName}/${constants_1.NGINX_CONFIG_FILENAME}`)} \
|
|
62
|
+
--build-arg NGINX_BASE_CONF_LOCATION=${(0, shell_1.shellQuote)(`./${tempDirName}/${constants_1.BASE_NGINX_CONFIG_FILENAME}`)} \
|
|
63
|
+
${extraArgs} \
|
|
64
|
+
-t ${(0, shell_1.shellQuote)(imageFullName)} ${(0, shell_1.shellQuote)(context)}`;
|
|
65
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { type ArtifactsOptions } from '../config/types';
|
|
2
|
+
import { type BeforeBuildHook } from '../pipeline/host-pipeline';
|
|
3
|
+
export type BuildDockerImageOptions = ArtifactsOptions & {
|
|
4
|
+
/** Аргументы командной строки (`name=... version=... registry=...`), накладываются поверх опций. */
|
|
5
|
+
argv?: string[];
|
|
6
|
+
/**
|
|
7
|
+
* Хук, вызываемый после подготовки файлов и очистки `buildPath`, но до сборки приложения и
|
|
8
|
+
* `docker build`. Если приложение собирается им, выставьте `build.command: null`.
|
|
9
|
+
*/
|
|
10
|
+
beforeBuild?: BeforeBuildHook;
|
|
11
|
+
};
|
|
12
|
+
/**
|
|
13
|
+
* Высокоуровневая сборка docker-образа. Повторяет пайплайн команд `arui-scripts docker-build` и
|
|
14
|
+
* `arui-scripts docker-build:compiled`: донасыщает конфиг, рендерит все шаблоны, готовит временную
|
|
15
|
+
* директорию, прогоняет хост-пайплайн, запускает `docker build`, чистит за собой и (опционально)
|
|
16
|
+
* пушит образ.
|
|
17
|
+
*
|
|
18
|
+
* Для более тонкого контроля используйте отдельные утилиты: {@link resolveArtifactsConfig},
|
|
19
|
+
* {@link renderTemplates}, {@link prepareFilesForDocker}, {@link getDockerBuildCommand}.
|
|
20
|
+
*/
|
|
21
|
+
export declare function buildDockerImage(options?: BuildDockerImageOptions): Promise<void>;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.buildDockerImage = buildDockerImage;
|
|
7
|
+
const fs_extra_1 = __importDefault(require("fs-extra"));
|
|
8
|
+
const config_1 = require("../config");
|
|
9
|
+
const host_pipeline_1 = require("../pipeline/host-pipeline");
|
|
10
|
+
const render_1 = require("../pipeline/render");
|
|
11
|
+
const exec_1 = require("../utils/exec");
|
|
12
|
+
const build_command_1 = require("./build-command");
|
|
13
|
+
const build_params_1 = require("./build-params");
|
|
14
|
+
const prepare_files_1 = require("./prepare-files");
|
|
15
|
+
/**
|
|
16
|
+
* Высокоуровневая сборка docker-образа. Повторяет пайплайн команд `arui-scripts docker-build` и
|
|
17
|
+
* `arui-scripts docker-build:compiled`: донасыщает конфиг, рендерит все шаблоны, готовит временную
|
|
18
|
+
* директорию, прогоняет хост-пайплайн, запускает `docker build`, чистит за собой и (опционально)
|
|
19
|
+
* пушит образ.
|
|
20
|
+
*
|
|
21
|
+
* Для более тонкого контроля используйте отдельные утилиты: {@link resolveArtifactsConfig},
|
|
22
|
+
* {@link renderTemplates}, {@link prepareFilesForDocker}, {@link getDockerBuildCommand}.
|
|
23
|
+
*/
|
|
24
|
+
async function buildDockerImage(options = {}) {
|
|
25
|
+
const { argv, beforeBuild, templates, overrides, ...rest } = options;
|
|
26
|
+
let config = (0, config_1.resolveArtifactsConfig)({ ...rest, artifact: 'docker' });
|
|
27
|
+
if (argv) {
|
|
28
|
+
config = (0, build_params_1.applyCommandLineArguments)(config, argv);
|
|
29
|
+
}
|
|
30
|
+
const { imageFullName, pathToTempDir } = (0, build_params_1.getBuildParams)(config);
|
|
31
|
+
let restoreDockerIgnore = null;
|
|
32
|
+
try {
|
|
33
|
+
console.log(`Build docker image ${imageFullName}`);
|
|
34
|
+
console.time('Total time');
|
|
35
|
+
console.time('Setting up time');
|
|
36
|
+
const renderedTemplates = (0, render_1.renderTemplates)({ config, templates, overrides });
|
|
37
|
+
({ restoreDockerIgnore } = await (0, prepare_files_1.prepareFilesForDocker)({
|
|
38
|
+
config,
|
|
39
|
+
templates: renderedTemplates,
|
|
40
|
+
}));
|
|
41
|
+
console.timeEnd('Setting up time');
|
|
42
|
+
await (0, host_pipeline_1.runHostPipeline)(config, beforeBuild);
|
|
43
|
+
console.time('Build docker image time');
|
|
44
|
+
await (0, exec_1.exec)((0, build_command_1.getDockerBuildCommand)(config));
|
|
45
|
+
console.timeEnd('Build docker image time');
|
|
46
|
+
console.time('Cleanup time');
|
|
47
|
+
await fs_extra_1.default.remove(pathToTempDir);
|
|
48
|
+
await restoreDockerIgnore();
|
|
49
|
+
restoreDockerIgnore = null;
|
|
50
|
+
if (config.docker.push) {
|
|
51
|
+
await (0, exec_1.exec)(`docker push ${imageFullName}`);
|
|
52
|
+
}
|
|
53
|
+
console.timeEnd('Cleanup time');
|
|
54
|
+
console.timeEnd('Total time');
|
|
55
|
+
}
|
|
56
|
+
catch (err) {
|
|
57
|
+
await fs_extra_1.default.remove(pathToTempDir);
|
|
58
|
+
await restoreDockerIgnore?.();
|
|
59
|
+
console.error('Error during docker-build.');
|
|
60
|
+
if (config.debug) {
|
|
61
|
+
console.error(err);
|
|
62
|
+
}
|
|
63
|
+
throw err;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { type ResolvedArtifactsConfig } from '../config/types';
|
|
2
|
+
export type BuildParams = {
|
|
3
|
+
pathToTempDir: string;
|
|
4
|
+
imageFullName: string;
|
|
5
|
+
tempDirName: string;
|
|
6
|
+
};
|
|
7
|
+
/**
|
|
8
|
+
* Собирает параметры сборки (полное имя образа и пути) из конфига.
|
|
9
|
+
*/
|
|
10
|
+
export declare function getBuildParams(config: ResolvedArtifactsConfig): BuildParams;
|
|
11
|
+
/**
|
|
12
|
+
* Разбирает аргументы командной строки вида `name=... version=... registry=...` и накладывает их
|
|
13
|
+
* поверх конфига. Неизвестные аргументы игнорируются с предупреждением.
|
|
14
|
+
*/
|
|
15
|
+
export declare function applyCommandLineArguments(config: ResolvedArtifactsConfig, commandLineArguments: string[]): ResolvedArtifactsConfig;
|
|
16
|
+
/**
|
|
17
|
+
* Как {@link getBuildParams}, но с учетом аргументов командной строки (по умолчанию — `process.argv`,
|
|
18
|
+
* начиная с третьего, как в CLI arui-scripts).
|
|
19
|
+
*/
|
|
20
|
+
export declare function getBuildParamsFromArgs(config: ResolvedArtifactsConfig, argv?: string[]): BuildParams;
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.getBuildParams = getBuildParams;
|
|
7
|
+
exports.applyCommandLineArguments = applyCommandLineArguments;
|
|
8
|
+
exports.getBuildParamsFromArgs = getBuildParamsFromArgs;
|
|
9
|
+
const path_1 = __importDefault(require("path"));
|
|
10
|
+
/**
|
|
11
|
+
* Собирает параметры сборки (полное имя образа и пути) из конфига.
|
|
12
|
+
*/
|
|
13
|
+
function getBuildParams(config) {
|
|
14
|
+
const { name, version, cwd, docker } = config;
|
|
15
|
+
const { registry, tempDirName } = docker;
|
|
16
|
+
const pathToTempDir = path_1.default.join(cwd, tempDirName);
|
|
17
|
+
const imageFullName = `${registry ? `${registry}/` : ''}${name}:${version}`;
|
|
18
|
+
return { pathToTempDir, imageFullName, tempDirName };
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Разбирает аргументы командной строки вида `name=... version=... registry=...` и накладывает их
|
|
22
|
+
* поверх конфига. Неизвестные аргументы игнорируются с предупреждением.
|
|
23
|
+
*/
|
|
24
|
+
function applyCommandLineArguments(config, commandLineArguments) {
|
|
25
|
+
const next = { ...config, docker: { ...config.docker } };
|
|
26
|
+
commandLineArguments.forEach((arg) => {
|
|
27
|
+
let [argName, argValue] = arg.split('=');
|
|
28
|
+
argName = argName.toLowerCase().trim();
|
|
29
|
+
argValue = argValue ? argValue.trim() : '';
|
|
30
|
+
switch (argName) {
|
|
31
|
+
case 'version':
|
|
32
|
+
next.version = argValue;
|
|
33
|
+
break;
|
|
34
|
+
case 'name':
|
|
35
|
+
next.name = argValue;
|
|
36
|
+
break;
|
|
37
|
+
case 'registry':
|
|
38
|
+
next.docker.registry = argValue;
|
|
39
|
+
break;
|
|
40
|
+
default:
|
|
41
|
+
console.warn(`Unknown argument ${argName}`);
|
|
42
|
+
}
|
|
43
|
+
});
|
|
44
|
+
return next;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Как {@link getBuildParams}, но с учетом аргументов командной строки (по умолчанию — `process.argv`,
|
|
48
|
+
* начиная с третьего, как в CLI arui-scripts).
|
|
49
|
+
*/
|
|
50
|
+
function getBuildParamsFromArgs(config, argv = process.argv.slice(3)) {
|
|
51
|
+
return getBuildParams(applyCommandLineArguments(config, argv));
|
|
52
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Имя временной директории, в которую складываются сгенерированные файлы (Dockerfile, nginx-конфиги,
|
|
3
|
+
* start.sh) перед запуском `docker build`.
|
|
4
|
+
*/
|
|
5
|
+
export declare const DEFAULT_TEMP_DIR_NAME = ".docker-build";
|
|
6
|
+
/** Базовый docker-образ по умолчанию. */
|
|
7
|
+
export declare const DEFAULT_BASE_DOCKER_IMAGE = "alfabankui/arui-scripts:24.10.0-slim";
|
|
8
|
+
/** Имя Dockerfile во временной директории. */
|
|
9
|
+
export declare const DOCKERFILE_FILENAME = "Dockerfile";
|
|
10
|
+
/** Имя файла со списком исключений сборочного контекста. */
|
|
11
|
+
export declare const DOCKERIGNORE_FILENAME = ".dockerignore";
|
|
12
|
+
/**
|
|
13
|
+
* Минимальная версия docker, начиная с которой флаг `--platform` поддерживается без экспериментальных
|
|
14
|
+
* флагов. На многих серверах до сих пор живет docker 1.13.1, который упадет при наличии этого флага.
|
|
15
|
+
* @see https://docs.docker.com/engine/release-notes/20.10/
|
|
16
|
+
*/
|
|
17
|
+
export declare const PLATFORM_FLAG_MIN_DOCKER_VERSION = ">=20.10.21";
|
|
18
|
+
/** Значение флага `--platform`, которое подставляется при `platform: 'auto'` на новых версиях docker. */
|
|
19
|
+
export declare const DEFAULT_PLATFORM = "linux/x86_64";
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.DEFAULT_PLATFORM = exports.PLATFORM_FLAG_MIN_DOCKER_VERSION = exports.DOCKERIGNORE_FILENAME = exports.DOCKERFILE_FILENAME = exports.DEFAULT_BASE_DOCKER_IMAGE = exports.DEFAULT_TEMP_DIR_NAME = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* Имя временной директории, в которую складываются сгенерированные файлы (Dockerfile, nginx-конфиги,
|
|
6
|
+
* start.sh) перед запуском `docker build`.
|
|
7
|
+
*/
|
|
8
|
+
exports.DEFAULT_TEMP_DIR_NAME = '.docker-build';
|
|
9
|
+
/** Базовый docker-образ по умолчанию. */
|
|
10
|
+
exports.DEFAULT_BASE_DOCKER_IMAGE = 'alfabankui/arui-scripts:24.10.0-slim';
|
|
11
|
+
/** Имя Dockerfile во временной директории. */
|
|
12
|
+
exports.DOCKERFILE_FILENAME = 'Dockerfile';
|
|
13
|
+
/** Имя файла со списком исключений сборочного контекста. */
|
|
14
|
+
exports.DOCKERIGNORE_FILENAME = '.dockerignore';
|
|
15
|
+
/**
|
|
16
|
+
* Минимальная версия docker, начиная с которой флаг `--platform` поддерживается без экспериментальных
|
|
17
|
+
* флагов. На многих серверах до сих пор живет docker 1.13.1, который упадет при наличии этого флага.
|
|
18
|
+
* @see https://docs.docker.com/engine/release-notes/20.10/
|
|
19
|
+
*/
|
|
20
|
+
exports.PLATFORM_FLAG_MIN_DOCKER_VERSION = '>=20.10.21';
|
|
21
|
+
/** Значение флага `--platform`, которое подставляется при `platform: 'auto'` на новых версиях docker. */
|
|
22
|
+
exports.DEFAULT_PLATFORM = 'linux/x86_64';
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export { buildDockerImage, type BuildDockerImageOptions } from './build-docker-image';
|
|
2
|
+
export { applyCommandLineArguments, getBuildParams, getBuildParamsFromArgs, type BuildParams, } from './build-params';
|
|
3
|
+
export { dockerVersionSatisfies, getDockerBuildCommand, getPlatformFlag } from './build-command';
|
|
4
|
+
export { prepareFilesForDocker, type PrepareFilesForDockerResult } from './prepare-files';
|
|
5
|
+
export { renderDockerfile } from './templates/dockerfile.template';
|
|
6
|
+
export { renderDockerfileCompiled } from './templates/dockerfile-compiled.template';
|
|
7
|
+
export { DEFAULT_BASE_DOCKER_IMAGE, DEFAULT_PLATFORM, DEFAULT_TEMP_DIR_NAME, DOCKERFILE_FILENAME, DOCKERIGNORE_FILENAME, PLATFORM_FLAG_MIN_DOCKER_VERSION, } from './constants';
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.PLATFORM_FLAG_MIN_DOCKER_VERSION = exports.DOCKERIGNORE_FILENAME = exports.DOCKERFILE_FILENAME = exports.DEFAULT_TEMP_DIR_NAME = exports.DEFAULT_PLATFORM = exports.DEFAULT_BASE_DOCKER_IMAGE = exports.renderDockerfileCompiled = exports.renderDockerfile = exports.prepareFilesForDocker = exports.getPlatformFlag = exports.getDockerBuildCommand = exports.dockerVersionSatisfies = exports.getBuildParamsFromArgs = exports.getBuildParams = exports.applyCommandLineArguments = exports.buildDockerImage = void 0;
|
|
4
|
+
var build_docker_image_1 = require("./build-docker-image");
|
|
5
|
+
Object.defineProperty(exports, "buildDockerImage", { enumerable: true, get: function () { return build_docker_image_1.buildDockerImage; } });
|
|
6
|
+
var build_params_1 = require("./build-params");
|
|
7
|
+
Object.defineProperty(exports, "applyCommandLineArguments", { enumerable: true, get: function () { return build_params_1.applyCommandLineArguments; } });
|
|
8
|
+
Object.defineProperty(exports, "getBuildParams", { enumerable: true, get: function () { return build_params_1.getBuildParams; } });
|
|
9
|
+
Object.defineProperty(exports, "getBuildParamsFromArgs", { enumerable: true, get: function () { return build_params_1.getBuildParamsFromArgs; } });
|
|
10
|
+
var build_command_1 = require("./build-command");
|
|
11
|
+
Object.defineProperty(exports, "dockerVersionSatisfies", { enumerable: true, get: function () { return build_command_1.dockerVersionSatisfies; } });
|
|
12
|
+
Object.defineProperty(exports, "getDockerBuildCommand", { enumerable: true, get: function () { return build_command_1.getDockerBuildCommand; } });
|
|
13
|
+
Object.defineProperty(exports, "getPlatformFlag", { enumerable: true, get: function () { return build_command_1.getPlatformFlag; } });
|
|
14
|
+
var prepare_files_1 = require("./prepare-files");
|
|
15
|
+
Object.defineProperty(exports, "prepareFilesForDocker", { enumerable: true, get: function () { return prepare_files_1.prepareFilesForDocker; } });
|
|
16
|
+
var dockerfile_template_1 = require("./templates/dockerfile.template");
|
|
17
|
+
Object.defineProperty(exports, "renderDockerfile", { enumerable: true, get: function () { return dockerfile_template_1.renderDockerfile; } });
|
|
18
|
+
var dockerfile_compiled_template_1 = require("./templates/dockerfile-compiled.template");
|
|
19
|
+
Object.defineProperty(exports, "renderDockerfileCompiled", { enumerable: true, get: function () { return dockerfile_compiled_template_1.renderDockerfileCompiled; } });
|
|
20
|
+
var constants_1 = require("./constants");
|
|
21
|
+
Object.defineProperty(exports, "DEFAULT_BASE_DOCKER_IMAGE", { enumerable: true, get: function () { return constants_1.DEFAULT_BASE_DOCKER_IMAGE; } });
|
|
22
|
+
Object.defineProperty(exports, "DEFAULT_PLATFORM", { enumerable: true, get: function () { return constants_1.DEFAULT_PLATFORM; } });
|
|
23
|
+
Object.defineProperty(exports, "DEFAULT_TEMP_DIR_NAME", { enumerable: true, get: function () { return constants_1.DEFAULT_TEMP_DIR_NAME; } });
|
|
24
|
+
Object.defineProperty(exports, "DOCKERFILE_FILENAME", { enumerable: true, get: function () { return constants_1.DOCKERFILE_FILENAME; } });
|
|
25
|
+
Object.defineProperty(exports, "DOCKERIGNORE_FILENAME", { enumerable: true, get: function () { return constants_1.DOCKERIGNORE_FILENAME; } });
|
|
26
|
+
Object.defineProperty(exports, "PLATFORM_FLAG_MIN_DOCKER_VERSION", { enumerable: true, get: function () { return constants_1.PLATFORM_FLAG_MIN_DOCKER_VERSION; } });
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { type RenderedTemplates, type ResolvedArtifactsConfig } from '../config/types';
|
|
2
|
+
type PrepareFilesForDockerParams = {
|
|
3
|
+
config: ResolvedArtifactsConfig;
|
|
4
|
+
templates: RenderedTemplates;
|
|
5
|
+
};
|
|
6
|
+
export type PrepareFilesForDockerResult = {
|
|
7
|
+
/**
|
|
8
|
+
* Возвращает `.dockerignore` проекта в исходное состояние. Вызывать после `docker build` —
|
|
9
|
+
* иначе дописанный `node_modules` останется в рабочей копии пользователя.
|
|
10
|
+
*/
|
|
11
|
+
restoreDockerIgnore: () => Promise<void>;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Готовит временную директорию со всеми файлами, необходимыми для `docker build`: Dockerfile,
|
|
15
|
+
* nginx-конфиги и start.sh. Локальные файлы проекта (если разрешены и заданы) имеют приоритет над
|
|
16
|
+
* сгенерированными шаблонами.
|
|
17
|
+
*/
|
|
18
|
+
export declare function prepareFilesForDocker({ config, templates, }: PrepareFilesForDockerParams): Promise<PrepareFilesForDockerResult>;
|
|
19
|
+
export {};
|