Skip to main content

CustomTemplate

Resource CustomTemplate in pulumi-portainer.
4 min read

Resource CustomTemplate in pulumi-portainer.

Pulumi type: portainer:index/customTemplate:CustomTemplate.

name is the Pulumi resource name. Nested object fields are documented under that object. They are not arguments of this resource.

Example#

Only required arguments are set. A string in angle brackets stands in for that argument. Any other value is an option or example written in the SDK description.

Arguments#

PropertyTypeRequiredDescription
composeFilePathstringnoPath within the Git repository to the Compose or manifest file (defaults to docker-compose.yml).
customTemplateIdstringno
descriptionstringyesShort description of the custom template displayed in the Portainer UI.
edgeTemplatebooleannoWhether this template is exposed as an Edge template.
fileContentstringnoInline template body (Compose YAML, Kubernetes manifest, or Swarm stack file). Mutually exclusive with filePath and the repository fields.
filePathstringnoPath on the local filesystem to a file containing the template body. Mutually exclusive with fileContent and the repository fields.
isComposeFormatbooleannoWhether the Kubernetes manifest is provided in Compose format (only relevant for type = 3).
logostringnoURL of the logo image displayed next to the template in the Portainer UI.
notestringyesAdditional note or instructions associated with the custom template.
platformnumberyesTarget platform for the template: 1 = Linux, 2 = Windows.
repositoryAuthenticationbooleannoEnable authentication for the Git repository (default: false).
repositoryPasswordstringnoSensitive password or personal access token used to authenticate against the Git repository.
repositoryReferencestringnoGit reference (branch, tag, or commit) to check out (defaults to refs/heads/main).
repositoryUrlstringnoURL of the Git repository hosting the template manifest.
repositoryUsernamestringnoUsername used to authenticate against the Git repository.
titlestringyesTitle of the Portainer custom template.
tlsskipVerifybooleannoWhether to skip TLS verification when cloning the Git repository.
typenumberyesTemplate type: 1 = Swarm stack, 2 = Compose stack, 3 = Kubernetes manifest.
variables{ [key: string]: string }[]noList of template variable definitions (name, label, description, defaultValue) used for parameterized templates.

Outputs#

Computed outputs are produced by the provider. They are not constructor arguments.

PropertyTypeComputedDescription
composeFilePathstringnoPath within the Git repository to the Compose or manifest file (defaults to docker-compose.yml).
customTemplateIdstringno
descriptionstringnoShort description of the custom template displayed in the Portainer UI.
edgeTemplatebooleannoWhether this template is exposed as an Edge template.
fileContentstringnoInline template body (Compose YAML, Kubernetes manifest, or Swarm stack file). Mutually exclusive with filePath and the repository fields.
filePathstringnoPath on the local filesystem to a file containing the template body. Mutually exclusive with fileContent and the repository fields.
isComposeFormatbooleannoWhether the Kubernetes manifest is provided in Compose format (only relevant for type = 3).
logostringnoURL of the logo image displayed next to the template in the Portainer UI.
notestringnoAdditional note or instructions associated with the custom template.
platformnumbernoTarget platform for the template: 1 = Linux, 2 = Windows.
repositoryAuthenticationbooleannoEnable authentication for the Git repository (default: false).
repositoryPasswordstringnoSensitive password or personal access token used to authenticate against the Git repository.
repositoryReferencestringnoGit reference (branch, tag, or commit) to check out (defaults to refs/heads/main).
repositoryUrlstringnoURL of the Git repository hosting the template manifest.
repositoryUsernamestringnoUsername used to authenticate against the Git repository.
titlestringnoTitle of the Portainer custom template.
tlsskipVerifybooleannoWhether to skip TLS verification when cloning the Git repository.
typenumbernoTemplate type: 1 = Swarm stack, 2 = Compose stack, 3 = Kubernetes manifest.
variables{ [key: string]: string }[]noList of template variable definitions (name, label, description, defaultValue) used for parameterized templates.