RemoteManifest

k8s.nyl/v1

Kubernetes Rendering Resources · Download JSON Schema · Usage guide

Fetches HTTPS YAML or JSON documents and expands them into Kubernetes manifests.

Fetched documents enter the recursive render pipeline. Namespace overriding applies when explicitly requested.

When needed

Use this optional resource to fetch HTTPS YAML or JSON documents into the render pipeline.

If omitted

Nyl does not fetch remote manifests automatically. Other authored resources render normally without a RemoteManifest.

Example

apiVersion: k8s.nyl/v1
kind: RemoteManifest
metadata:
  name: workloads
  namespace: workloads
spec:
  url: https://example.com/manifests/app.yaml

Fields

Required means required within the containing object. Optional and nullable are distinct; contextual defaults and requirements are explained with each field.

Unknown fields are rejected.

apiVersion

Required · string

API version (must be core Nyl API version)

const: "k8s.nyl/v1"

kind

Required · string

Resource kind (always “RemoteManifest”)

const: "RemoteManifest"

metadata

Required · object

Kubernetes metadata

Unknown fields are rejected.

metadata.annotations

Optional · object

Annotations

metadata.annotations[key]

Optional · string

metadata.labels

Optional · object

Labels

metadata.labels[key]

Optional · string

metadata.name

Required · string

Resource name

metadata.namespace

Optional · string or null

Namespace (optional)

spec

Required · object

Remote manifest source configuration

Unknown fields are rejected.

Choose exactly one variant:

• url — Fetches the manifests at this single URL.
• urls — Fetches the manifests at each URL, in order.

spec.overrideNamespace

Optional · boolean

Overwrite fetched manifest metadata.namespace with RemoteManifest metadata.namespace

spec.params

Optional · object or null

Parameters for {key} substitution in urls URL templates

spec.params[key]

Optional · string

spec.url

Optional · string or null

Single HTTPS URL to fetch (mutually exclusive with urls)

spec.urls

Optional · array or null

List of HTTPS URL templates to fetch (mutually exclusive with url)

spec.urls[]

Required · string