Use a manifest - IDYL Docs

Use a manifest when you want a repeatable workload definition. Apply reads one or more YAML documents from a file and creates or updates each resource.

1. Write a workload manifest

kind: Deployment
metadata:
  name: web
  subnet: <subnet>
spec:
  replicas: 2
  template:
    spec:
      containers:
        - name: web
          imageURI: nginx:1.25
          resources:
            requests:
              cpu: 500m
              memory: 256Mi
            limits:
              cpu: 500m
              memory: 256Mi

Save the file as web.yaml.

2. Apply the manifest

idyl apply -f web.yaml

3. Check the result

idyl get deployment web
idyl get pod

4. Update from the manifest

Edit web.yaml, then apply the updated manifest:

idyl apply -f web.yaml

Sandbox manifest

Sandbox manifests require metadata.name and spec.ttl. Use metadata.subnet or pass --subnet when applying the file.

kind: Sandbox
metadata:
  name: dev
  subnet: <subnet>
spec:
  ttl: 2h
  template:
    spec:
      containers:
        - name: main
          imageURI: ubuntu:24.04
          command: ["sleep", "infinity"]
      isolation:
        class: microvm

Apply the Sandbox:

idyl apply -f sandbox.yaml

Scope rules

The CLI resolves the Account and Namespace from flags, manifest metadata, and the current context, in that order. A flag wins over a value in the manifest, and the manifest wins over the entered context. Direct Workload manifests require Namespace scope and do not name a Workspace. Namespace names are unique within the Account. Use --namespace when you want the command to be explicit:

idyl apply -f web.yaml --namespace <namespace>

The target subnet belongs in workload metadata as metadata.subnet. You can also use --subnet to override the manifest value for one command. Use the resource manifest reference for exact generated YAML fields, examples, allowed values, and read-only fields.

​1. Write a workload manifest

​2. Apply the manifest

​3. Check the result

​4. Update from the manifest

​Sandbox manifest

​Scope rules