image-factory

module
v1.0.3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 9, 2026 License: MPL-2.0

README

Image Factory

The Image Factory provides a way to download Talos Linux artifacts. Artifacts can be generated with customizations defined by a "schematic". A schematic can be applied to any of the versions of Talos Linux offered by the Image Factory to produce a "model".

The following assets are provided:

  • ISO
  • kernel, initramfs, and kernel command line
  • UKI
  • disk images in various formats (e.g. AWS, GCP, VMware, etc.)
  • installer container images

The supported frontends are:

  • HTTP
  • PXE
  • Container Registry

The official Image Factory is available at https://factory.talos.dev.

Documentation

License

The Image Factory is licensed under the Mozilla Public License, version 2.0, except for the code in the enterprise/ folder, which is licensed under the Business Source License 1.1.

The enterprise code is not included in the open source version of Image Factory, and it is not built by default.

Directories

Path Synopsis
cmd
image-factory command
Package main is the entrypoint of the image factory.
 Package main is the entrypoint of the image factory.
image-factory/cmd
Package cmd implements the entrypoint of the image factory.
 Package cmd implements the entrypoint of the image factory.
image-factory/flags
internal
artifacts
Package artifacts handles acquiring and caching source Talos artifacts.
 Package artifacts handles acquiring and caching source Talos artifacts.
artifacts/internal/image
Package image provides utilities for working with container image signatures.
 Package image provides utilities for working with container image signatures.
asset
Package asset implements generation of Talos build assets.
 Package asset implements generation of Talos build assets.
asset/cache
Package cache provides an interface for caching boot assets.
 Package cache provides an interface for caching boot assets.
asset/cache/cdn
Package cdn implements a cache wrapper for boot assets, rewriting URLs to go through CDN.
 Package cdn implements a cache wrapper for boot assets, rewriting URLs to go through CDN.
asset/cache/registry
Package registry implements a cache using an OCI registry.
 Package registry implements a cache using an OCI registry.
asset/cache/s3
Package s3 implements a cache for boot assets using S3-compatible storage.
 Package s3 implements a cache for boot assets using S3-compatible storage.
frontend/http
Package http implements the HTTP frontend.
 Package http implements the HTTP frontend.
image/signer
Package signer implements simplified cosign-compatible OCI image signer.
 Package signer implements simplified cosign-compatible OCI image signer.
profile
Package profile implements handling of Talos profiles.
 Package profile implements handling of Talos profiles.
regtransport
Package regtransport implements utilities for interacting with registry transport.
 Package regtransport implements utilities for interacting with registry transport.
remotewrap
Package remotewrap implements a wrapper around go-containerregistry's remote package.
 Package remotewrap implements a wrapper around go-containerregistry's remote package.
remotewrap/internal/refresher
Package refresher implements a simple refresh on interval mechanism.
 Package refresher implements a simple refresh on interval mechanism.
schematic
Package schematic implements schematic factory: storing image schematics.
 Package schematic implements schematic factory: storing image schematics.
schematic/storage
Package storage implements a storage for schematic data.
 Package storage implements a storage for schematic data.
schematic/storage/cache
Package cache implements an in-memory cache over schematic storage.
 Package cache implements an in-memory cache over schematic storage.
schematic/storage/registry
Package registry implements a schematic storage in OCI registry.
 Package registry implements a schematic storage in OCI registry.
secureboot
Package secureboot implements handling SecureBoot options.
 Package secureboot implements handling SecureBoot options.
version
Package version contains variables such as project name, tag and sha.
 Package version contains variables such as project name, tag and sha.
pkg
client
Package client implements image factory HTTP API client.
 Package client implements image factory HTTP API client.
constants
Package constants defines image factory public constants.
 Package constants defines image factory public constants.
enterprise
Package enterprise provide glue to Enterprise code.
 Package enterprise provide glue to Enterprise code.
schematic
Package schematic provides a data model for requested image schematic.
 Package schematic provides a data model for requested image schematic.
docgen command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.