Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

qga

package

Go to main page

Versions in this module

v0

v0.11.0

Oct 25, 2026

Changes in this version

+ func ScriptPath(target Target, executionID, name string) string

type Bridge

+ func (b *Bridge) RunWithExtras(ctx context.Context, target Target, executionID string, ...) (*GuestResult, error)

type Command

+ Script *Script

+ type Script struct

+ Body string

+ Name string

type Target

+ Linux bool

+ func (t Target) OSIdentity() string

v0.10.0

Oct 20, 2026

Changes in this version

+ const EnvEnabled

+ const EnvKeyFile

+ const MaxArgBytes

+ const MaxArgs

+ const MaxCwdBytes

+ const MaxDeadlineSeconds

+ const MaxEnvelopeBytes

+ const MaxExecutableBytes

+ const MaxOutputBytes

+ var ErrConfiguration = errors.New("QGA pilot transport configuration is invalid")

+ var ErrDenied = errors.New("QGA target denied")

+ var ErrNotStarted = errors.New("runner could not be started")

+ var ErrRequestTooLarge = errors.New("QGA pilot request is too large")

+ var ErrTransport = errors.New("QGA transport failed")

+ var ErrUnavailable = errors.New("QGA target unavailable")

+ func LoadSigner(path string) (*grants.Signer, error)

+ func RunBudget(deadlineSeconds int) time.Duration

+ type Bridge struct

+ func NewBridge(exec ExecFunc) (*Bridge, error)

+ func (b *Bridge) Run(ctx context.Context, target Target, executionID string, ...) (*GuestResult, error)

+ type Command struct

+ ActorUID string

+ Args []string

+ Cwd *string

+ DeadlineSeconds int

+ Executable string

+ ExecutionID string

+ RecordingID string

+ type Config struct

+ Enabled bool

+ KeyFile string

+ func ConfigFromEnv() (Config, error)

+ type ExecFunc func(ctx context.Context, namespace, pod, container string, command []string, ...) (stdout, stderr []byte, err error)

+ func KubernetesExecFunc(config *rest.Config, client kubernetes.Interface) (ExecFunc, error)

+ type GuestResult struct

+ Denial string

+ DurationMS uint64

+ ExitCode *int

+ Outcome string

+ Stderr []byte

+ Stdout []byte

+ Truncated bool

+ type PolicyReader interface

+ GetVMExecutionPolicy func(context.Context) (platform.VMExecutionPolicy, error)

+ type Resolver struct

+ func NewResolver(client dynamic.Interface, policy PolicyReader) (*Resolver, error)

+ func (r *Resolver) Resolve(ctx context.Context, namespace, name string) (Target, error)

+ type Runtime struct

+ func NewRuntime(cfg Config, dyn dynamic.Interface, policy PolicyReader, ...) (*Runtime, error)

+ func NewRuntimeWithExec(signer *grants.Signer, resolver TargetResolver, exec ExecFunc) (*Runtime, error)

+ func (r *Runtime) Execute(ctx context.Context, target Target, command Command) (*GuestResult, error)

+ func (r *Runtime) Resolve(ctx context.Context, namespace, name string) (Target, error)

+ type Target struct

+ Domain string

+ Namespace string

+ PodName string

+ PodUID string

+ RevocationEpoch uint64

+ VMUID string

+ WorkspaceName string

+ WorkspaceUID string

+ type TargetResolver interface

+ Resolve func(ctx context.Context, namespace, name string) (Target, error)