ContainerDeployerParameters

@webda/oci

---

Class: ContainerDeployerParameters

Defined in: packages/oci/src/container.service.ts:26

Parameters of the ContainerDeployer

Every string can use the deployment templates: ${package.version}, ${git.commit}, ${deployment}, ${deployer.name}, ${env.MY_VAR}, ...

Extends

• ServiceParameters

Constructors

Constructor

new ContainerDeployerParameters(): ContainerDeployerParameters

Returns

ContainerDeployerParameters

Inherited from

ServiceParameters.constructor

Properties

baseImage

baseImage: string

Defined in: packages/oci/src/container.service.ts:32

Base image, scratch for none

Default

"node:22-slim"

---

cmd

cmd: string[]

Defined in: packages/oci/src/container.service.ts:65

Command of the image, the arguments of the entrypoint

Default

["serve", "--bind", "0.0.0.0"]

---

credentials

credentials: Record<string, RegistryCredentials>

Defined in: packages/oci/src/container.service.ts:120

Credentials per registry host, they take precedence over ~/.docker/config.json

Default

Use templates to read them from the environment: { "ghcr.io": { "username": "${env.GHCR_USER}", "password": "${env.GHCR_TOKEN}" } }

password, identityToken and token can be encrypted with webda config encrypt

---

entrypoint

entrypoint: string[]

Defined in: packages/oci/src/container.service.ts:59

Entrypoint of the image

Default

["node", "<workdir>/node_modules/@webda/core/lib/bin/cli.js"]

---

env

env: Record<string, string>

Defined in: packages/oci/src/container.service.ts:71

Environment variables

Default

{ "NODE_ENV": "production" }

---

exposedPorts

exposedPorts: string[]

Defined in: packages/oci/src/container.service.ts:86

Exposed ports

Default

["18080/tcp"]

---

image?

optional image?: string

Defined in: packages/oci/src/container.service.ts:38

Repository to push to, without tag: ghcr.io/my-org/my-app

Required to push.

---

insecureRegistries

insecureRegistries: string[]

Defined in: packages/oci/src/container.service.ts:125

Registries reached over plain http, localhost and 127.0.0.1 always are

Default

[]

---

labels

labels: Record<string, string>

Defined in: packages/oci/src/container.service.ts:76

Labels, added to the default OCI ones (version, revision, source, title)

Default

{}

---

mtime?

optional mtime?: number

Defined in: packages/oci/src/container.service.ts:111

Modification time of the files and creation time of the image, in seconds

Default

the SOURCE_DATE_EPOCH environment variable, or 0

---

output

output: string

Defined in: packages/oci/src/container.service.ts:100

Output of container build: an OCI layout folder, or a tar archive when ending with .tar

Relative to the application folder. The folder keeps the downloaded base layers between builds.

Default

".webda/oci/${deployer.name}"

---

package

package: PackageOptions

Defined in: packages/oci/src/container.service.ts:105

Options of the application packaging

Default

{}

---

platforms

platforms: string[]

Defined in: packages/oci/src/container.service.ts:92

Platforms to build, several platforms produce a multi-platform index

Default

["linux/amd64"]

---

tags

tags: string[]

Defined in: packages/oci/src/container.service.ts:47

Tags of the image

Invalid characters are replaced by -, so the snapshot version 1.2.4+20261004120000 becomes 1.2.4-20261004120000.

Default

["${git.version}"]

---

type

type: string

Defined in: packages/core/lib/services/serviceparameters.d.ts:9

Type of the service

Inherited from

ServiceParameters.type

---

user?

optional user?: string

Defined in: packages/oci/src/container.service.ts:80

User the container runs as, the base image one by default

---

workdir

workdir: string

Defined in: packages/oci/src/container.service.ts:53

Folder of the application in the image

Default

"/app"

Methods

load()

load(params?): this

Defined in: packages/oci/src/container.service.ts:130

Parameters

params?

any = {}

Returns

this

Overrides

ServiceParameters.load

---

update()

update(params, delta): this

Defined in: packages/core/lib/application/parameters.d.ts:21

Update parameters and call watchers if a parameter was changed

Parameters

params

any

the service parameters

delta

any

the delta

Returns

this

this for chaining

Inherited from

ServiceParameters.update

---

with()

with(callback): this

Defined in: packages/core/lib/application/parameters.d.ts:27

Watch for changes on the parameters and call watchers when a parameter is changed

Parameters

callback

(params) => void

the callback function

Returns

this

this for chaining

Inherited from

ServiceParameters.with