Skip to main content

Loading Kubernetes YAML

If you already have lots of existing Kubernetes YAML files, you don't have to rewrite all of them in JavaScript. Kosko provides two ways for you to load Kubernetes YAML files.

Load YAML Files

This is the easiest way to import your existing Kubernetes YAML files. It's recommended to try this first if you don't need to manipulate YAML files. All manifests except custom resource definitions (CRD) are created with kubernetes-models, so they are validated against Kubernetes OpenAPI schema.


npm install @kosko/yaml

Load from a File

import { loadFile } from "@kosko/yaml";


Load from a URL

import { loadUrl } from "@kosko/yaml";

// Load from a URL

You can customize headers or method in options. See node-fetch for more information about available options.

import { loadUrl } from "@kosko/yaml";

loadUrl("", {
method: "POST",
headers: {
Authorization: "token"

Load from a String

import { loadString } from "@kosko/yaml";

apiVersion: v1
kind: Pod
name: my-pod

Transform Manifests

import { loadFile } from "@kosko/yaml";
import { Service } from "kubernetes-models/v1/Service";

loadFile("manifest.yaml", {
transform(manifest) {
// Remove all manifests whose namespace is "foo"
if (manifest.metadata.namespace === "foo") {
return null;

// Set all service type as "ClusterIP"
if ( {
manifest.spec.type = "ClusterIP";

// You must return the manifest, otherwise it will be removed.
return manifest;

Custom Resources

Register custom resource definitions (CRD) with setResourceModule function.

import { setResourceModule } from "@kosko/yaml";

apiVersion: "",
kind: "HTTPProxy"
path: "@kubernetes-models/contour/",
export: "HTTPProxy"

Opt-out Validation

By default, all manifests except custom resource definitions (CRD) are created with kubernetes-models. If you don't want to validate them for some reasons, you can transform them into plain objects, or override the validate method.

import { loadFile } from "@kosko/yaml";

loadFile("manifest.yaml", {
tranform(manifest) {
// Return the plain object
if (typeof manifest.toJSON === "function") {
return manifest.toJSON();

// Override the validate method
manifest.validate = () => {};

return manifest;

Migrate YAML Files

If you want to maximize the power of kosko, you can try to migrate your existing Kubernetes YAML files into JavaScript files.

First, install @kosko/yaml package.

npm install @kosko/yaml

Then, use kosko migrate command to migrate Kubernetes YAML files.

# Read from file or a directory
kosko migrate -f manifest.yaml > components/nginx.js

# Read from stdin
cat manifest.yaml | kosko migrate -f - > components/nginx.js

See kosko migrate for more information about available options.