Skip to content

Build and publish a Go binary as a minimal OCI image

License

Notifications You must be signed in to change notification settings

ryanfowler/gopack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gopack

Build and publish a Go binary as a minimal OCI image

gopack uses your locally installed version of Go to cross-compile your application, building an OCI image with the resulting binary, and pushing your image to a remote repository or a locally running daemon. Docker not required.

Install

gopack can be installed using the command:

go install github.com/ryanfowler/gopack/cmd/gopack@latest

Go 1.18+ is required.

Usage

Use the gopack run command to build and publish an image. Although all flags are optional, some notable flags are:

  • --base: image to use as the base (default: gcr.io/distroless/static:nonroot)
  • --repository: repository to push the final image to (default: Go binary name)
  • --platform: platform(s) to build the image(s) for (default: linux/amd64)
  • --tag: tag(s) to push the image with (default: latest)
  • --daemon: push the final image to a local daemon, instead of the remote repository (e.g. docker)

Using a custom base image

gopack run ./cmd/gopack -b myimage:tag

Pushing to a specific remote respository

gopack run ./cmd/gopack -r ghcr.io/OWNER/gopack

Building for multiple platforms

gopack run ./cmd/gopack -p linux/amd64 -p linux/arm64

Specifying tags

gopack run ./cmd/gopack -t latest -t 12345678

Push to a local daemon

gopack run ./cmd/gopack --daemon docker

Please run gopack run -h for more information about the available options.

License

Copyright 2023 Ryan Fowler

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.