-
- All Implemented Interfaces:
-
kotlin.Comparable,org.gradle.api.Task,org.gradle.api.internal.DynamicObjectAware,org.gradle.api.internal.TaskInternal,org.gradle.api.plugins.ExtensionAware,org.gradle.util.Configurable,org.unbrokendome.gradle.plugins.helm.command.ConfigurableHelmInstallFromRepositoryOptions,org.unbrokendome.gradle.plugins.helm.command.ConfigurableHelmInstallationOptions,org.unbrokendome.gradle.plugins.helm.command.ConfigurableHelmOptions,org.unbrokendome.gradle.plugins.helm.command.ConfigurableHelmServerOperationOptions,org.unbrokendome.gradle.plugins.helm.command.ConfigurableHelmServerOptions,org.unbrokendome.gradle.plugins.helm.command.ConfigurableHelmValueOptions,org.unbrokendome.gradle.plugins.helm.command.GlobalHelmOptions,org.unbrokendome.gradle.plugins.helm.command.HelmInstallFromRepositoryOptions,org.unbrokendome.gradle.plugins.helm.command.HelmInstallationOptions,org.unbrokendome.gradle.plugins.helm.command.HelmOptions,org.unbrokendome.gradle.plugins.helm.command.HelmServerOperationOptions,org.unbrokendome.gradle.plugins.helm.command.HelmServerOptions,org.unbrokendome.gradle.plugins.helm.command.HelmValueOptions
public class HelmTemplate extends AbstractHelmInstallationCommandTask
Renders chart templates locally.
-
-
Field Summary
-
Constructor Summary
Constructors Constructor Description HelmTemplate()
-
Method Summary
Modifier and Type Method Description Property<String>getReleaseName()final ListProperty<String>getApiVersions()Kubernetes API versions used for Capabilities.APIVersions.final Property<Boolean>getReplace()If true, re-use the given release name, even if that name is already used.final Property<Boolean>getIsUpgrade()If true, setRelease.IsUpgradeinstead ofRelease.IsInstall.final ListProperty<String>getShowOnly()If not empty, only output manifests rendered from the given templates. final Property<Boolean>getValidate()If true, validate your manifests against the Kubernetes cluster you are currently pointing at.final Property<Boolean>getUseReleaseNameInOutputPath()If true, use the release name in the output path.final DirectoryPropertygetOutputDir()Directory into which the template output files will be written. final Property<String>getChart()The chart to be installed. Property<String>getVersion()Specify the exact chart version to install. final Property<Boolean>getAtomic()If true, roll back changes on failure.final RegularFilePropertygetCaFile()Verify certificates of HTTPS-enabled servers using this CA bundle. final RegularFilePropertygetCertFile()Identify HTTPS client using this SSL certificate file. final Property<Boolean>getDevel()If true, use development versions, too.final RegularFilePropertygetKeyFile()Identify HTTPS client using this SSL key file. final Property<String>getPassword()Chart repository password where to locate the requested chart. final Property<URI>getRepository()Chart repository URL where to locate the requested chart. final Property<String>getUsername()Chart repository username where to locate the requested chart. final MapProperty<String, Object>getValues()Values to be used for the release. final MapProperty<String, Object>getFileValues()Values read from the contents of files, to be used for the release. final ConfigurableFileCollectiongetValueFiles()A collection of YAML files containing values for this release. final Property<Boolean>getVerify()If true, verify the package before installing it.final Property<Boolean>getWait()If true, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful.final Property<Boolean>getWaitForJobs()If true, and wait is alsotrue, will wait until all Jobs have been completed before marking the release as successful.final Property<Boolean>getCreateNamespace()If true, create the release namespace if not present.final Property<Boolean>getDryRun()If true, only simulate the operation.final Property<Boolean>getNoHooks()If true, prevent hooks from running during the operation.final Property<Duration>getRemoteTimeout()Time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks). final RegularFilePropertygetKubeConfig()Path to the Kubernetes configuration file. final Property<String>getKubeContext()Name of the kubeconfig context to use. final Property<String>getNamespace()Namespace scope for this request. final Provider<String>getExecutable()final Provider<Boolean>getDebug()final Provider<List<String>>getExtraArgs()final Provider<Directory>getXdgDataHome()final Provider<Directory>getXdgConfigHome()final Provider<Directory>getXdgCacheHome()final UnitrenderTemplate()-
Methods inherited from class org.unbrokendome.gradle.plugins.helm.command.tasks.HelmTemplate
from -
Methods inherited from class org.unbrokendome.gradle.plugins.helm.command.tasks.AbstractHelmCommandTask
compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService -
Methods inherited from class org.gradle.api.DefaultTask
appendParallelSafeAction, getAsDynamicObject, getConvention, getIdentityPath, getImpliesSubProjects, getOnlyIf, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, isEnabled, isHasCustomActions, prependParallelSafeAction, setImpliesSubProjects, setLoggerMessageRewriter -
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
-
Method Detail
-
getReleaseName
@Input()@Optional() Property<String> getReleaseName()
-
getApiVersions
@Input() final ListProperty<String> getApiVersions()
Kubernetes API versions used for
Capabilities.APIVersions.Corresponds to the
--api-versionsCLI option.
-
getReplace
@Internal() final Property<Boolean> getReplace()
If
true, re-use the given release name, even if that name is already used.Corresponds to the
--replaceCLI option.
-
getIsUpgrade
@Input()@Optional() final Property<Boolean> getIsUpgrade()
If
true, setRelease.IsUpgradeinstead ofRelease.IsInstall.Corresponds to the
--is-upgradeCLI option.
-
getShowOnly
@Input() final ListProperty<String> getShowOnly()
If not empty, only output manifests rendered from the given templates.
Corresponds to the
--show-onlyCLI option.
-
getValidate
@Internal() final Property<Boolean> getValidate()
If
true, validate your manifests against the Kubernetes cluster you are currently pointing at. This is the same validation performed on an install.Corresponds to the
--validateCLI option.
-
getUseReleaseNameInOutputPath
@Input()@Optional() final Property<Boolean> getUseReleaseNameInOutputPath()
If
true, use the release name in the output path.Corresponds to the
--release-nameCLI option.
-
getOutputDir
@OutputDirectory() final DirectoryProperty getOutputDir()
Directory into which the template output files will be written.
Corresponds to the
--output-dirCLI option.
-
getChart
@Input() final Property<String> getChart()
The chart to be installed. This can be any of the forms accepted by the Helm CLI.
chart reference: e.g.
stable/mariadbpath to a packaged chart
path to an unpacked chart directory
absolute URL: e.g.
https://example.com/charts/nginx-1.2.3.tgzsimple chart reference, e.g.
mariadb(you must also set the repository property in this case)
-
getVersion
@Input()@Optional() Property<String> getVersion()
Specify the exact chart version to install. If this is not specified, the latest version is installed.
Corresponds to the
--versionHelm CLI parameter.
-
getAtomic
@Internal() final Property<Boolean> getAtomic()
If
true, roll back changes on failure.Corresponds to the
--atomicHelm CLI parameter.
-
getCaFile
@Internal() final RegularFileProperty getCaFile()
Verify certificates of HTTPS-enabled servers using this CA bundle.
Corresponds to the
--ca-fileCLI parameter.
-
getCertFile
@Internal() final RegularFileProperty getCertFile()
Identify HTTPS client using this SSL certificate file.
Corresponds to the
--cert-fileCLI parameter.
-
getDevel
@Input()@Optional() final Property<Boolean> getDevel()
If
true, use development versions, too. Equivalent to version>0.0.0-0. If version is set, this is ignored.Corresponds to the
--develCLI parameter.
-
getKeyFile
@Internal() final RegularFileProperty getKeyFile()
Identify HTTPS client using this SSL key file.
Corresponds to the
--key-fileCLI parameter.
-
getPassword
@Internal() final Property<String> getPassword()
Chart repository password where to locate the requested chart.
Corresponds to the
--passwordCLI parameter.
-
getRepository
@Input()@Optional() final Property<URI> getRepository()
Chart repository URL where to locate the requested chart.
Corresponds to the
--repoHelm CLI parameter.Use this when the chart property contains only a simple chart reference, without a symbolic repository name.
-
getUsername
@Internal() final Property<String> getUsername()
Chart repository username where to locate the requested chart.
Corresponds to the
--usernameCLI parameter.
-
getValues
@Input() final MapProperty<String, Object> getValues()
Values to be used for the release.
Entries in the map will be sent to the CLI using either the
--set-stringoption (for strings) or the--setoption (for all other types).
-
getFileValues
@Input() final MapProperty<String, Object> getFileValues()
Values read from the contents of files, to be used for the release.
Corresponds to the
--set-fileCLI option.The values of the map can be of any type that is accepted by Project.file. Additionally, when adding a Provider that represents an output file of another task, this task will automatically have a task dependency on the producing task.
Not to be confused with valueFiles, which contains a collection of YAML files that supply multiple values.
-
getValueFiles
@InputFiles() final ConfigurableFileCollection getValueFiles()
A collection of YAML files containing values for this release.
Corresponds to the
--valuesCLI option.Not to be confused with fileValues, which contains entries whose values are the contents of files.
-
getVerify
@Internal() final Property<Boolean> getVerify()
If
true, verify the package before installing it.Corresponds to the
--verifyCLI parameter.
-
getWait
@Internal() final Property<Boolean> getWait()
If
true, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful. It will wait for as along as remoteTimeout.
-
getWaitForJobs
@Internal() final Property<Boolean> getWaitForJobs()
If
true, and wait is alsotrue, will wait until all Jobs have been completed before marking the release as successful. It will wait for as long as remoteTimeout.
-
getCreateNamespace
@Internal() final Property<Boolean> getCreateNamespace()
If
true, create the release namespace if not present.Corresponds to the
--create-namespaceCLI parameter.
-
getDryRun
@Internal() final Property<Boolean> getDryRun()
If
true, only simulate the operation.Corresponds to the
--dry-runCLI parameter.
-
getNoHooks
@Internal() final Property<Boolean> getNoHooks()
If
true, prevent hooks from running during the operation.Corresponds to the
--no-hooksCLI parameter.
-
getRemoteTimeout
@Internal() final Property<Duration> getRemoteTimeout()
Time in seconds to wait for any individual Kubernetes operation (like Jobs for hooks). Default is 300.
Corresponds to the
--timeoutcommand line option in the Helm CLI.
-
getKubeConfig
@InputFile()@Optional() final RegularFileProperty getKubeConfig()
Path to the Kubernetes configuration file.
If this property is set, its value will be used to set the
KUBECONFIGenvironment variable for each Helm invocation.
-
getKubeContext
@Input()@Optional() final Property<String> getKubeContext()
Name of the kubeconfig context to use.
Corresponds to the
--kube-contextcommand line option in the Helm CLI.
-
getNamespace
@Internal() final Property<String> getNamespace()
Namespace scope for this request.
Corresponds to the
--namespaceCLI parameter.
-
getExecutable
@Input() final Provider<String> getExecutable()
-
getExtraArgs
@Input() final Provider<List<String>> getExtraArgs()
-
getXdgDataHome
@Internal() final Provider<Directory> getXdgDataHome()
-
getXdgConfigHome
@Internal() final Provider<Directory> getXdgConfigHome()
-
getXdgCacheHome
@Internal() final Provider<Directory> getXdgCacheHome()
-
renderTemplate
final Unit renderTemplate()
-
-
-
-