This documentation is for people who develop, maintain, or verify the
local-irsa repository.
User workflows and command reference are in the manual:
Do not put user command reference, release work, or design reconciliation notes in this development documentation.
Use these tools for local development:
- Go 1.26 or later. This repository uses Go 1.26.2 in
go.modand devbox. devbox.- Taskfile.
kind.kubectl.- a Docker-compatible container runtime.
task up downloads the cert-manager manifest from GitHub Releases, so the
development machine needs network access to GitHub Releases.
When using devbox, check the Go version with:
devbox run go version
The user-facing setup method is a Go tool dependency pinned in the user's
project go.mod:
go get -tool github.com/appthrust/local-irsa/cmd/local-irsa@<version>
go tool local-irsa --help
Use a concrete <version> instead of @latest when documenting repeatable
user setup.
Users who intentionally want a global personal binary can still use
go install, but that is not the main documentation path:
go install github.com/appthrust/local-irsa/cmd/local-irsa@<version>
To install a development build from a checkout, run this at the repository root:
go install ./cmd/local-irsa
For one-time local runs during development, use:
go run ./cmd/local-irsa <subcommand> ...
Release binaries, package managers, and container images are not defined yet.