Skip to main content

omnictl apply

Create or update resource using YAML file or directory as an input

Synopsis

Create or update resources using YAML file(s) as input. If a file is specified, only that file will be processed. If a directory is specified, all YAML files (*.yaml, *.yml) in the directory and its subdirectories will be processed recursively. Each file is processed independently, similar to kubectl behavior.

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl audit-log

Read audit log from Omni

Synopsis

Read audit log from Omni. Optionally filter by date range using start and end arguments in YYYY-MM-DD format (date-only, interpreted in the server’s local time, e.g. 2024-01-01).

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl cluster delete

Delete all cluster resources.

Synopsis

Delete all resources related to the cluster. The command waits for the cluster to be fully destroyed.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster import abort

Abort an ongoing cluster import operation

Synopsis

Abort an ongoing cluster import operation. This will clean up any resources created during the import process and will only work if the cluster is locked and tainted as “importing”

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster import

Cluster import related commands.

Synopsis

Commands to manage cluster import operation.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster kubernetes manifest-sync

Sync Kubernetes bootstrap manifests from Talos controlplane nodes to Kubernetes API.

Synopsis

Sync Kubernetes bootstrap manifests from Talos controlplane nodes to Kubernetes API. Bootstrap manifests might be updated with Talos version update, Kubernetes upgrade, and config patching. Talos never updates or deletes Kubernetes manifests, so this command fills the gap to keep manifests up-to-date.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster kubernetes upgrade-pre-checks

Run Kubernetes upgrade pre-checks for the cluster.

Synopsis

Verify that upgrading Kubernetes version is available for the cluster: version compatibility, deprecated APIs, etc.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster kubernetes

Cluster Kubernetes management subcommands.

Synopsis

Commands to render, validate, manage cluster templates.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster lock

Lock the cluster

Synopsis

When locked, no config updates, upgrades and downgrades will be performed on the cluster nodes.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster machine delete

Delete the machine from the cluster

Synopsis

Delete the machine from the cluster. The command waits for the machine to be fully deleted.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster machine lock

Lock the machine

Synopsis

When locked, no config updates, upgrades and downgrades will be performed on the machine.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster machine unlock

Unlock the machine

Synopsis

Removes locked annotation from the machine.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster machine

Machine related commands.

Synopsis

Commands to manage cluster machines.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster secret rotate kubernetes-ca

Rotate Kubernetes CA certificate.

Synopsis

Rotate Kubernetes CA certificate for all nodes in the cluster. Kubernetes CA is used by the Kubernetes API server and kubelet for authenticating clients.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster secret rotate status

Show secret rotation status, wait for the rotation to complete.

Synopsis

Shows current secret rotation status, if the terminal supports it, watch the status as it updates. The command waits for the secret to be fully rotated by default.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster secret rotate talos-ca

Rotate Talos CA certificate.

Synopsis

Rotate Talos CA certificate for all nodes in the cluster. Talos CA is used by Talos API.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster secret rotate

Rotate cluster secrets, wait for the rotation to complete.

Synopsis

Rotates specified cluster secret, if the terminal supports it, watch the secret update steps. The command waits for the secret to be fully rotated by default.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster secret

Cluster secret management subcommands.

Synopsis

Commands to manage cluster secrets.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster status

Show cluster status, wait for the cluster to be ready.

Synopsis

Shows current cluster status, if the terminal supports it, watch the status as it updates. The command waits for the cluster to be ready by default.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template delete

Delete all cluster template resources from Omni.

Synopsis

Delete all resources related to the cluster template. This command requires API access.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template diff

Show diff in resources if the template is synced.

Synopsis

Query existing resources for the cluster and compare them with the resources generated from the template. This command requires API access.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template export

Export a cluster template from an existing cluster on Omni.

Synopsis

Export a cluster template from an existing cluster on Omni. This command requires API access.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template render

Render a cluster template to a set of resources.

Synopsis

Validate template contents, convert to resources and output resources to stdout as YAML. This command is offline (doesn’t access API).

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template status

Show template cluster status, wait for the cluster to be ready.

Synopsis

Shows current cluster status, if the terminal supports it, watch the status as it updates. The command waits for the cluster to be ready by default.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template sync

Apply template to the Omni.

Synopsis

Query existing resources for the cluster and compare them with the resources generated from the template, create/update/delete resources as needed. This command requires API access. If a file is specified, only that file will be processed. If a directory is specified, all YAML files (*.yaml, *.yml) in the directory and its subdirectories will be processed recursively. Each template file is processed independently, allowing management of multiple clusters.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template validate

Validate a cluster template.

Synopsis

Validate that template contains valid structures, and there are no other warnings. This command is offline (doesn’t access API).

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster template

Cluster template management subcommands.

Synopsis

Commands to render, validate, manage cluster templates.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster unlock

Unlock the cluster

Synopsis

Removes locked annotation from the cluster.

Options

Options inherited from parent commands

SEE ALSO

omnictl cluster

Cluster-related subcommands.

Synopsis

Commands to destroy clusters and manage cluster templates.

Options

Options inherited from parent commands

SEE ALSO

omnictl completion bash

Generate the autocompletion script for bash

Synopsis

Generate the autocompletion script for the bash shell. This script depends on the ‘bash-completion’ package. If it is not installed already, you can install it via your OS’s package manager. To load completions in your current shell session:
To load completions for every new session, execute once:

Linux:

macOS:

You will need to start a new shell for this setup to take effect.

Options

Options inherited from parent commands

SEE ALSO

omnictl completion fish

Generate the autocompletion script for fish

Synopsis

Generate the autocompletion script for the fish shell. To load completions in your current shell session:
To load completions for every new session, execute once:
You will need to start a new shell for this setup to take effect.

Options

Options inherited from parent commands

SEE ALSO

omnictl completion powershell

Generate the autocompletion script for powershell

Synopsis

Generate the autocompletion script for powershell. To load completions in your current shell session:
To load completions for every new session, add the output of the above command to your powershell profile.

Options

Options inherited from parent commands

SEE ALSO

omnictl completion zsh

Generate the autocompletion script for zsh

Synopsis

Generate the autocompletion script for the zsh shell. If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:
To load completions in your current shell session:
To load completions for every new session, execute once:

Linux:

macOS:

You will need to start a new shell for this setup to take effect.

Options

Options inherited from parent commands

SEE ALSO

omnictl completion

Generate the autocompletion script for the specified shell

Synopsis

Generate the autocompletion script for omnictl for the specified shell. See each sub-command’s help for details on how to use the generated script.

Options

Options inherited from parent commands

SEE ALSO

omnictl config add

Add a new context

Options

Options inherited from parent commands

SEE ALSO

omnictl config context

Set the current context

Options

Options inherited from parent commands

SEE ALSO

omnictl config contexts

List defined contexts

Options

Options inherited from parent commands

SEE ALSO

omnictl config identity

Set the auth identity for the current context

Options

Options inherited from parent commands

SEE ALSO

omnictl config info

Show information about the current context

Options

Options inherited from parent commands

SEE ALSO

omnictl config merge

Merge additional contexts from another client configuration file

Synopsis

Contexts with the same name are renamed while merging configs.

Options

Options inherited from parent commands

SEE ALSO

omnictl config new

Generate a new client configuration file

Options

Options inherited from parent commands

SEE ALSO

omnictl config url

Set the URL for the current context

Options

Options inherited from parent commands

SEE ALSO

omnictl config

Manage the client configuration file (omniconfig)

Options

Options inherited from parent commands

SEE ALSO

omnictl configure machine

Machine configuration command.

Options

Options inherited from parent commands

SEE ALSO

omnictl configure

Configuration subcommands.

Options

Options inherited from parent commands

SEE ALSO

omnictl delete

Delete a specific resource by ID or all resources of the type.

Synopsis

Similar to ‘kubectl delete’, ‘omnictl delete’ initiates resource deletion and waits for the operation to complete.

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl download

Download installer media

Synopsis

This command downloads installer media from the server It accepts one argument, which is the name of the image to download. Name can be one of the following:
  • iso - downloads the latest ISO image
  • AWS AMI (amd64), Vultr (arm64), Raspberry Pi 4 Model B - full image name
  • oracle, aws, vmware - platform name
  • rpi_generic, rockpi_4c, rock64 - board name
To get the full list of available images, look at the output of the following command: omnictl get installationmedia -o yaml The download command tries to match the passed string in this order:
  • name
  • profile
By default it will download amd64 image if there are multiple images available for the same name. For example, to download the latest ISO image for arm64, run: omnictl download iso —arch amd64 To download the same ISO with two extensions added, the —extensions argument gets repeated to produce a stringArray: omnictl download iso —arch amd64 —extensions intel-ucode —extensions qemu-guest-agent To download the latest Vultr image, run: omnictl download “vultr” To download the latest Radxa ROCK PI 4 image, run: omnictl download “rpi_generic”

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl edit

Edit Omni resources with the default editor.

Synopsis

The edit command allows you to directly edit the resources of an Omni instance using your preferred text editor. It will open the editor defined by your OMNI_EDITOR, TALOS_EDITOR, or EDITOR environment variables, or fall back to ‘vi’ for Linux or ‘notepad’ for Windows.

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl get

Get a specific resource or list of resources.

Synopsis

Similar to ‘kubectl get’, ‘omnictl get’ returns a set of resources from the OS. To get a list of all available resource definitions, issue ‘omnictl get rd’

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl infraprovider create

Create an infra provider

Options

Options inherited from parent commands

SEE ALSO

omnictl infraprovider delete

Delete an infra provider

Options

Options inherited from parent commands

SEE ALSO

omnictl infraprovider list

List infra providers

Options

Options inherited from parent commands

SEE ALSO

omnictl infraprovider renewkey

Renew an infra provider service account by registering a new public key to it

Options

Options inherited from parent commands

SEE ALSO

omnictl infraprovider

Manage infra providers

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken create

Create a join token

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken delete

Delete a join token

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken kernel-args

Get Talos kernel args to make a machine join Omni

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken list

List join tokens

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken machine-config

Get partial machine config to make a machine join Omni

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken make-default

Make the token default one

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken omni-endpoint

Get the Omni endpoint URL with the join token

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken renew

Renew a join token

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken revoke

Revoke a join token

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken unrevoke

Unrevoke a join token

Options

Options inherited from parent commands

SEE ALSO

omnictl jointoken

Manage join tokens

Options

Options inherited from parent commands

SEE ALSO

omnictl kubeconfig

Download the admin kubeconfig of a cluster

Synopsis

Download the admin kubeconfig of a cluster. If merge flag is defined, config will be merged with ~/.kube/config or [local-path] if specified. Otherwise kubeconfig will be written to PWD or [local-path] if specified.

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl machine-logs

Get logs for a machine

Synopsis

Get logs for a provided machine id

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl serviceaccount create

Create a service account

Options

Options inherited from parent commands

SEE ALSO

omnictl serviceaccount destroy

Destroy a service account

Options

Options inherited from parent commands

SEE ALSO

omnictl serviceaccount list

List service accounts

Options

Options inherited from parent commands

SEE ALSO

omnictl serviceaccount renew

Renew a service account by registering a new public key to it

Options

Options inherited from parent commands

SEE ALSO

omnictl serviceaccount

Manage service accounts

Options

Options inherited from parent commands

SEE ALSO

omnictl support

Download the support bundle for a cluster

Synopsis

The command collects all non-sensitive information for the cluster from the Omni state.

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl talosconfig

Download an admin talosconfig.

Synopsis

Download the generic admin talosconfig of the Omni instance or the admin talosconfig of a cluster. Generic talosconfig can be used with any machine, including those in maintenance mode. If merge flag is defined, config will be merged with ~/.talos/config or [local-path] if specified. Otherwise talosconfig will be written to PWD or [local-path] if specified.

Options

Options inherited from parent commands

SEE ALSO

  • omnictl - A CLI for accessing Omni API.

omnictl user create

Create a user.

Synopsis

Create a user with the specified email.

Options

Options inherited from parent commands

SEE ALSO

omnictl user delete

Delete users.

Synopsis

Delete users with the specified emails.

Options

Options inherited from parent commands

SEE ALSO

omnictl user list

List all users.

Synopsis

List all existing users on the Omni instance.

Options

Options inherited from parent commands

SEE ALSO

omnictl user set-role

Update the role of the user.

Synopsis

Update the user role.

Options

Options inherited from parent commands

SEE ALSO

omnictl user

User-related subcommands.

Synopsis

Commands to manage users.

Options

Options inherited from parent commands

SEE ALSO

omnictl

A CLI for accessing Omni API.

Options

SEE ALSO