Packages > pkg.pkl-lang.org/pkl-pantry/k8s.contrib

k8s.contrib.convert1.0.3

Overview
Properties
Methods

open module k8s.contrib.convert

Converts a Kubernetes YAML manifest file to Pkl.

Module URI:: package://pkg.pkl-lang.org/pkl-pantry/k8s.contrib@1.0.3#/convert.pkl
Pkl version:: 0.25.0 or higher
Source code:: convert.pkl
Known subtypes:
Known usages:
All versions:

Evaluating the generated Pkl file will output (an equivalent of) the original YAML. Evaluating multiple generated Pkl files at once will output a single YAML stream.

Prerequisites

The pkl command is installed.

Usage

To convert deployment.yml to deployment.pkl, run:

pkl eval -p input=deployment.yml \
    -o deployment.pkl \
    package://pkg.pkl-lang.org/pkl-pantry/k8s.contrib@<version>#/convert.pkl

To validate the generated Pkl file, run pkl eval deployment.pkl.

Known limitations

YAML comments are not preserved.
YAML aliases are inlined.

Properties(show inherited)

link

hidden

output: ModuleOutput (pkl.base)Source

The output of this module.

Defaults to all module properties rendered as either Pcf or the format specified on the command line.
link

resourcesToConvert: List<Mapping>Source

The Kubernetes resources to convert.

Each resource is an object of type Mapping as produced by yaml.Parser.

Defaults to the resources contained in the YAML file passed with -p input=path/to/file.yml.
link

resourceConverters: Mapping<String, (Mapping) -> Any>Source

Converters to be sequentially applied to resourcesToConvert.

The default resourceConverters suffice to convert standard Kubernetes resources.
link
customResourceTemplates: Mapping<String, Mapping<String, K8sResource>>Source

Resource templates to be used for converting custom resources.
The first String key is the resource's kind, the second its apiVersion.

Example:
```
customResourceTemplates {
  ["Custom"] {
     ["v1"] = import("Custom.pkl")
  }
}
```
link

input: unknownSource

Methods(show inherited)

link

function

getClass(): Class (pkl.base)Source

Returns the class of this.
link

function

toString(): String (pkl.base)Source

Returns a string representation of this.

This method is used to convert the values of string interpolation expressions to strings.
link

function

ifNonNull<Result>(transform: (NonNull) -> Result): Result? (pkl.base)Source

Returns this |> transform if this is non-null, and null otherwise.

This method is the complement of the ?? operator and the equivalent of an Option type's map and flatMap methods.
link

function

hasProperty(name: String): Boolean (pkl.base)Source

Tells if this object has a property with the given name.
link

function

getProperty(name: String): unknown (pkl.base)Source

Returns the value of the property with the given name.

Throws if a property with this name does not exist.
link

function

getPropertyOrNull(name: String): unknown? (pkl.base)Source

Returns the value of the property with the given name.

Returns null if a property with this name does not exist.
link

function

toDynamic(): Dynamic (pkl.base)Source

Converts this object to a Dynamic object.
link

function

toMap(): Map<String, unknown> (pkl.base)Source

Converts this object to a Map.
link

function
relativePathTo(other: Module): List<String> (pkl.base)Source

Returns the relative, descendent directory path between this module and other.
Throws if no such path exists.

For example, if module mod1 has path /dir1/mod1.pkl, and module mod2 has path /dir1/dir2/dir3/mod2.pkl, then mod1.relativePathTo(mod2) will return List("dir2", "dir3").

A common use case is to compute the directory path between a template located at the root of a hierarchy (say rootModule.pkl) and the currently evaluated module (accessible via the module keyword):
```
import "rootModule.pkl" // self-import
path = rootModule.relativePathTo(module)
```
link

function

getResourceTemplate(resource: Mapping): K8sResource Source
link

function

getResourceTemplateUri(resource: Mapping): String Source
link

function

resourceConverterFn(resource: unknown): unknownSource