├── .gitignore
├── go.mod
├── .github
    ├── dependabot.yml
    └── workflows
    │   ├── cleanup.yml
    │   └── build.yml
├── Dockerfile
├── Makefile
├── LICENSE
├── tipper.go
└── README.md


/.gitignore:
--------------------------------------------------------------------------------
1 | *.tar.gz
2 | *.txt
3 | 


--------------------------------------------------------------------------------
/go.mod:
--------------------------------------------------------------------------------
1 | module github.com/AlekSi/golang-tip
2 | 
3 | go 1.24
4 | 
5 | toolchain go1.24.3
6 | 


--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | version: 2
 3 | updates:
 4 |   - package-ecosystem: "docker"
 5 |     directory: "/"
 6 |     schedule:
 7 |       interval: "weekly"
 8 |       day: "sunday"
 9 |       time: "02:48"
10 |   - package-ecosystem: "github-actions"
11 |     directory: "/"
12 |     schedule:
13 |       interval: "weekly"
14 |       day: "sunday"
15 |       time: "02:48"
16 | 


--------------------------------------------------------------------------------
/.github/workflows/cleanup.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Cleanup
 3 | on:
 4 |   workflow_dispatch:
 5 |   schedule:
 6 |     # https://docs.github.com/en/actions/reference/events-that-trigger-workflows#scheduled-events
 7 |     # > Note: The schedule event can be delayed during periods of high loads of GitHub Actions workflow runs.
 8 |     # > High load times include the start of every hour. To decrease the chance of delay, schedule your workflow to run at a different time of the hour.
 9 |     - cron: "48 5 * * *"
10 | 
11 | jobs:
12 |   docker:
13 |     name: Docker
14 |     timeout-minutes: 10
15 | 
16 |     runs-on: ubuntu-24.04
17 | 
18 |     steps:
19 |       - name: Delete old images
20 |         uses: actions/delete-package-versions@v5
21 |         with:
22 |           package-name: golang-tip
23 |           package-type: container
24 |           min-versions-to-keep: 365
25 |           delete-only-untagged-versions: true
26 | 


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
 1 | # syntax=docker/dockerfile:1
 2 | 
 3 | ARG GO_BRANCH
 4 | 
 5 | 
 6 | FROM --platform=$BUILDPLATFORM golang:1.24.3 AS prepare
 7 | 
 8 | RUN git clone https://go.googlesource.com/go /tmp/golang-tip
 9 | 
10 | 
11 | FROM golang:1.24.3
12 | 
13 | ARG GO_BRANCH
14 | 
15 | ENV GOLANG_VERSION=${GO_BRANCH}
16 | 
17 | COPY --from=prepare /tmp/golang-tip /tmp/golang-tip
18 | 
19 | RUN <<EOF
20 | set -ex
21 | 
22 | test -n "$GOLANG_VERSION"
23 | 
24 | cd /tmp/golang-tip
25 | git reset --hard
26 | git clean -xdf
27 | git remote prune origin
28 | git checkout "$GOLANG_VERSION"
29 | git pull
30 | 
31 | # RUN cd /tmp/golang-tip/src && env GOROOT_FINAL=/usr/local/go ./all.bash
32 | # TODO https://github.com/AlekSi/golang-tip/issues/3
33 | cd /tmp/golang-tip/src
34 | env GOROOT_FINAL=/usr/local/go ./make.bash
35 | 
36 | cd /
37 | rm -fr /usr/local/go
38 | rm -fr /tmp/golang-tip/.git
39 | mv /tmp/golang-tip /usr/local/go
40 | go version
41 | 
42 | # to save time to users
43 | go clean -cache
44 | go install -race std
45 | go install std
46 | 
47 | EOF
48 | 
49 | LABEL org.opencontainers.image.description="Daily builds of active Go development branches (branch ${GO_BRANCH})"
50 | LABEL org.opencontainers.image.url=https://github.com/AlekSi/golang-tip
51 | LABEL org.opencontainers.image.source=https://github.com/AlekSi/golang-tip
52 | 


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
 1 | GO_BRANCH ?= master
 2 | DOCKER_PLATFORM ?= linux
 3 | DOCKER_OUTPUT ?= type=docker
 4 | DOCKER_TAG ?= golang-tip:$(GO_BRANCH)
 5 | 
 6 | export GOEXPERIMENT = cacheprog
 7 | 
 8 | all: docker-build targz-build
 9 | 
10 | docker-up:
11 | 	docker buildx create --driver docker-container --name golang-tip
12 | 
13 | docker-down:
14 | 	docker buildx rm golang-tip
15 | 
16 | docker-build:
17 | 	test -n "$(GO_BRANCH)"
18 | 
19 | 	docker buildx build \
20 | 		--builder golang-tip \
21 | 		--platform $(DOCKER_PLATFORM) \
22 | 		--output $(DOCKER_OUTPUT) \
23 | 		--tag $(DOCKER_TAG) \
24 | 		--build-arg GO_BRANCH=$(GO_BRANCH) \
25 | 		.
26 | 
27 | # run tests when limits problem is fixed
28 | # TODO https://github.com/AlekSi/golang-tip/issues/4
29 | #
30 | # install std with -race
31 | # TODO https://github.com/AlekSi/golang-tip/issues/11
32 | targz-build:
33 | 	test -n "$(GO_BRANCH)"
34 | 	test -n "$(GOROOT_FINAL)"
35 | 
36 | 	rm -fr /tmp/golang-tip
37 | 	git clone --branch $(GO_BRANCH) --single-branch https://go.googlesource.com/go /tmp/golang-tip/$(shell basename $(GOROOT_FINAL))
38 | 	cd /tmp/golang-tip/$(shell basename $(GOROOT_FINAL))/src && env GOROOT_FINAL=$(GOROOT_FINAL) ./make.bash
39 | 	rm -fr /tmp/golang-tip/$(shell basename $(GOROOT_FINAL))/.git
40 | 	tar -czf golang-tip.tar.gz -C /tmp/golang-tip $(shell basename $(GOROOT_FINAL))
41 | 	rm -fr /tmp/golang-tip
42 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | BSD 2-Clause License
 2 | 
 3 | Copyright (c) 2021, Alexey Palazhchenko
 4 | All rights reserved.
 5 | 
 6 | Redistribution and use in source and binary forms, with or without
 7 | modification, are permitted provided that the following conditions are met:
 8 | 
 9 | 1. Redistributions of source code must retain the above copyright notice, this
10 |    list of conditions and the following disclaimer.
11 | 
12 | 2. Redistributions in binary form must reproduce the above copyright notice,
13 |    this list of conditions and the following disclaimer in the documentation
14 |    and/or other materials provided with the distribution.
15 | 
16 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
20 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
22 | SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
23 | CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 | OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 | 


--------------------------------------------------------------------------------
/tipper.go:
--------------------------------------------------------------------------------
  1 | package main
  2 | 
  3 | import (
  4 | 	"crypto/sha256"
  5 | 	"flag"
  6 | 	"fmt"
  7 | 	"io"
  8 | 	"log"
  9 | 	"os"
 10 | 	"path/filepath"
 11 | 	"runtime"
 12 | 	"strings"
 13 | 	"sync"
 14 | 	"time"
 15 | )
 16 | 
 17 | const (
 18 | 	checksumFileName = "sha256.txt"
 19 | )
 20 | 
 21 | func checksumFile(path string) (string, error) {
 22 | 	f, err := os.Open(path)
 23 | 	if err != nil {
 24 | 		return "", err
 25 | 	}
 26 | 	defer f.Close()
 27 | 
 28 | 	h := sha256.New()
 29 | 	if _, err = io.Copy(h, f); err != nil {
 30 | 		return "", err
 31 | 	}
 32 | 
 33 | 	return fmt.Sprintf("%064x", h.Sum(nil)), nil
 34 | }
 35 | 
 36 | func createChecksumFile() {
 37 | 	paths := make(chan string)
 38 | 	lines := make(chan string)
 39 | 
 40 | 	go func() {
 41 | 		err := filepath.Walk(".", func(path string, info os.FileInfo, err error) error {
 42 | 			if err != nil {
 43 | 				return err
 44 | 			}
 45 | 
 46 | 			if info.IsDir() {
 47 | 				if path == ".git" {
 48 | 					return filepath.SkipDir
 49 | 				}
 50 | 				return nil
 51 | 			}
 52 | 
 53 | 			if !strings.HasSuffix(path, ".tar.gz") {
 54 | 				return nil
 55 | 			}
 56 | 
 57 | 			paths <- path
 58 | 			return nil
 59 | 		})
 60 | 		if err != nil {
 61 | 			log.Fatal(err)
 62 | 		}
 63 | 		close(paths)
 64 | 	}()
 65 | 
 66 | 	var wg sync.WaitGroup
 67 | 	for i := 0; i < runtime.GOMAXPROCS(-1); i++ {
 68 | 		wg.Add(1)
 69 | 		go func() {
 70 | 			defer wg.Done()
 71 | 
 72 | 			for path := range paths {
 73 | 				checksum, err := checksumFile(path)
 74 | 				if err != nil {
 75 | 					log.Fatal(err)
 76 | 				}
 77 | 				lines <- fmt.Sprintf("%s  %s", checksum, path)
 78 | 			}
 79 | 		}()
 80 | 	}
 81 | 
 82 | 	go func() {
 83 | 		wg.Wait()
 84 | 		close(lines)
 85 | 	}()
 86 | 
 87 | 	f, err := os.Create(checksumFileName)
 88 | 	if err != nil {
 89 | 		log.Fatal(err)
 90 | 	}
 91 | 	for line := range lines {
 92 | 		if _, err = f.WriteString(line + "\n"); err != nil {
 93 | 			log.Fatal(err)
 94 | 		}
 95 | 	}
 96 | 	if err = f.Close(); err != nil {
 97 | 		log.Fatal(err)
 98 | 	}
 99 | 
100 | 	log.Printf("%s created.", checksumFileName)
101 | }
102 | 
103 | func createTimestampFile() {
104 | 	now := time.Now().UTC()
105 | 	name := fmt.Sprintf("Built on %s.txt", now.Format("2006-01-02"))
106 | 	data := []byte(fmt.Sprintf("Built on %s.\n", now.Format("2006-01-02T15:04:05Z07:00")))
107 | 	if err := os.WriteFile(name, data, 0o644); err != nil {
108 | 		log.Fatal(err)
109 | 	}
110 | 
111 | 	log.Printf("%q created.", name)
112 | }
113 | 
114 | func main() {
115 | 	log.SetPrefix("tipper: ")
116 | 	log.SetFlags(log.Lmsgprefix)
117 | 
118 | 	flag.Parse()
119 | 
120 | 	for _, cmd := range flag.Args() {
121 | 		switch cmd {
122 | 		case "all":
123 | 			createChecksumFile()
124 | 			createTimestampFile()
125 | 		case "checksum":
126 | 			createChecksumFile()
127 | 		case "timestamp":
128 | 			createTimestampFile()
129 | 		default:
130 | 			log.Fatalf("Unhandled command %q.", cmd)
131 | 		}
132 | 	}
133 | }
134 | 


--------------------------------------------------------------------------------
/.github/workflows/build.yml:
--------------------------------------------------------------------------------
  1 | ---
  2 | name: Build
  3 | on:
  4 |   schedule:
  5 |     # https://docs.github.com/en/actions/reference/events-that-trigger-workflows#scheduled-events
  6 |     # > Note: The schedule event can be delayed during periods of high loads of GitHub Actions workflow runs.
  7 |     # > High load times include the start of every hour. To decrease the chance of delay, schedule your workflow to run at a different time of the hour.
  8 |     - cron: "48 2 * * *"
  9 |     # For weekly autoreleases
 10 |     # TODO https://github.com/AlekSi/golang-tip/issues/5
 11 |     # - cron: '48 1 * * 0'
 12 |   push:
 13 |     branches:
 14 |       - main
 15 |   pull_request:
 16 |     paths-ignore: ["**.md"]
 17 | 
 18 | jobs:
 19 |   docker:
 20 |     name: Docker (${{ matrix.branch }})
 21 |     timeout-minutes: 60
 22 | 
 23 |     strategy:
 24 |       fail-fast: false
 25 |       matrix:
 26 |         os:
 27 |           - ubuntu-24.04
 28 |         branch:
 29 |           - master
 30 |           - release-branch.go1.24
 31 |           - release-branch.go1.23
 32 | 
 33 |     runs-on: ${{ matrix.os }}
 34 | 
 35 |     env:
 36 |       GO_BRANCH: ${{ matrix.branch }}
 37 | 
 38 |     steps:
 39 |       - name: Checkout
 40 |         uses: actions/checkout@v4
 41 | 
 42 |       - name: Setup QEMU
 43 |         uses: docker/setup-qemu-action@v3
 44 | 
 45 |       - name: Login into Docker registries
 46 |         if: github.event_name != 'pull_request'
 47 |         run: |
 48 |           docker login --username aleksi --password ${{ secrets.DOCKERHUB_TOKEN }}
 49 |           docker login ghcr.io --username aleksi --password ${{ secrets.GITHUB_TOKEN }}
 50 | 
 51 |       - name: Start BuildKit builder
 52 |         run: make docker-up
 53 | 
 54 |       - name: Build Docker images for PR
 55 |         if: github.event_name == 'pull_request'
 56 |         run: make docker-build
 57 | 
 58 |       - name: Build Docker images for Docker Hub
 59 |         if: github.event_name != 'pull_request'
 60 |         run: make docker-build
 61 |         env:
 62 |           DOCKER_PLATFORM: linux/amd64,linux/arm64
 63 |           DOCKER_OUTPUT: type=image,push=true,annotation-index.org.opencontainers.image.description="Daily builds of active Go development branches (branch ${{ env.GO_BRANCH }})"
 64 |           DOCKER_TAG: aleksi/golang-tip:${{ env.GO_BRANCH }}
 65 | 
 66 |       - name: Build Docker images for ghcr.io
 67 |         if: github.event_name != 'pull_request'
 68 |         run: make docker-build
 69 |         env:
 70 |           DOCKER_PLATFORM: linux/amd64,linux/arm64
 71 |           DOCKER_OUTPUT: type=image,push=true,annotation-index.org.opencontainers.image.description="Daily builds of active Go development branches (branch ${{ env.GO_BRANCH }})"
 72 |           DOCKER_TAG: ghcr.io/aleksi/golang-tip:${{ env.GO_BRANCH }}
 73 | 
 74 |       # skip push for PRs
 75 |       # move to `publish` job
 76 |       # TODO https://github.com/AlekSi/golang-tip/issues/8
 77 | 
 78 |   targz:
 79 |     name: TarGz (${{ matrix.branch }}, ${{ matrix.os }}, ${{ matrix.goroot }})
 80 |     timeout-minutes: 10
 81 | 
 82 |     strategy:
 83 |       fail-fast: false
 84 |       matrix:
 85 |         os:
 86 |           - ubuntu-24.04
 87 |           - macos-13
 88 |           - macos-15
 89 |         branch:
 90 |           - master
 91 |           - release-branch.go1.24
 92 |           - release-branch.go1.23
 93 |         goroot:
 94 |           - /usr/local/go
 95 |           - /tmp/golang-tip
 96 | 
 97 |     runs-on: ${{ matrix.os }}
 98 | 
 99 |     env:
100 |       GO_BRANCH: ${{ matrix.branch }}
101 |       GOROOT_FINAL: ${{ matrix.goroot }}
102 | 
103 |     steps:
104 |       - name: Checkout
105 |         uses: actions/checkout@v4
106 | 
107 |       - name: Setup Go
108 |         uses: actions/setup-go@v5
109 |         with:
110 |           go-version-file: go.mod
111 |           cache: false
112 | 
113 |       - name: Build .tar.gz file
114 |         run: make targz-build
115 | 
116 |       - name: Set artifact suffix
117 |         if: startsWith(env.GOROOT_FINAL, '/tmp/')
118 |         run: |
119 |           echo ARTIFACT_SUFFIX=.tmp >> $GITHUB_ENV
120 | 
121 |       - name: Set artifact name
122 |         run: |
123 |           echo ARTIFACT_NAME=${{ env.GO_BRANCH }}.$(go env GOOS)-$(go env GOARCH)${{ env.ARTIFACT_SUFFIX }} >> $GITHUB_ENV
124 | 
125 |       - name: Rename artifact
126 |         run: mv golang-tip.tar.gz ${{ env.ARTIFACT_NAME }}.tar.gz
127 | 
128 |       - name: Upload artifact
129 |         uses: actions/upload-artifact@v4
130 |         with:
131 |           name: ${{ env.ARTIFACT_NAME }}
132 |           path: ${{ env.ARTIFACT_NAME }}.tar.gz
133 |           if-no-files-found: error
134 | 
135 |   publish:
136 |     name: Publish
137 |     needs: [docker, targz]
138 |     timeout-minutes: 10
139 |     runs-on: ubuntu-24.04
140 |     if: github.actor != 'dependabot[bot]'
141 | 
142 |     steps:
143 |       - name: Checkout
144 |         uses: actions/checkout@v4
145 | 
146 |       - name: Download artifacts
147 |         uses: actions/download-artifact@v4
148 | 
149 |       - name: Prepare files
150 |         run: |
151 |           go version
152 |           go run tipper.go all
153 | 
154 |       - name: Publish artifacts
155 |         if: github.event_name != 'pull_request'
156 |         uses: marvinpinto/action-automatic-releases@v1.2.1
157 |         with:
158 |           repo_token: ${{ secrets.GITHUB_TOKEN }}
159 |           automatic_release_tag: tip
160 |           title: tip
161 |           prerelease: false
162 |           draft: false
163 |           files: |
164 |             **.tar.gz
165 |             *.txt
166 | 
167 |       - name: Publish PR artifacts
168 |         if: github.event_name == 'pull_request'
169 |         uses: marvinpinto/action-automatic-releases@v1.2.1
170 |         with:
171 |           repo_token: ${{ secrets.GITHUB_TOKEN }}
172 |           automatic_release_tag: test
173 |           title: Test release by pull request; do not use
174 |           prerelease: true
175 |           draft: false
176 |           files: |
177 |             **.tar.gz
178 |             *.txt
179 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | This repo is semi-deprecated in favor of new [official `golang:XXX-tip` images](https://hub.docker.com/_/golang)
  2 | that are rebuilt weekly but support more architectures.
  3 | 
  4 | ---
  5 | 
  6 | # golang-tip
  7 | 
  8 | [![Build](https://github.com/AlekSi/golang-tip/actions/workflows/build.yml/badge.svg?branch=main&event=schedule)](https://github.com/AlekSi/golang-tip/actions/workflows/build.yml)
  9 | [![Go Report Card](https://goreportcard.com/badge/github.com/AlekSi/golang-tip)](https://goreportcard.com/report/github.com/AlekSi/golang-tip)
 10 | 
 11 | Daily builds of [active Go development branches](https://github.com/golang/go/branches/active).
 12 | Available as:
 13 | * Docker images (based on [Go "Official Image"](https://github.com/docker-library/golang))
 14 | on both [Docker Hub](https://hub.docker.com/r/aleksi/golang-tip)
 15 | and [GitHub Container Registry](https://github.com/users/AlekSi/packages/container/package/golang-tip)
 16 | * [.tar.gz files](https://github.com/AlekSi/golang-tip/releases/tag/tip)
 17 | 
 18 | They may be used on CI/CD to avoid rebuilding Go from the source code every time, saving time and resources. They may also be used for local development.
 19 | 
 20 | 
 21 | # Quickstart
 22 | 
 23 | Examples for `master` / tip branch:
 24 | 
 25 | ```sh
 26 | docker pull aleksi/golang-tip:master
 27 | # or
 28 | docker pull ghcr.io/aleksi/golang-tip:master
 29 | 
 30 | # then use it as an official Go Docker image
 31 | ```
 32 | 
 33 | ```sh
 34 | # for Linux
 35 | curl -o master.tmp.tar.gz -L https://github.com/AlekSi/golang-tip/releases/download/tip/master.linux-amd64.tmp.tar.gz
 36 | 
 37 | # for macOS
 38 | curl -o master.tmp.tar.gz -L https://github.com/AlekSi/golang-tip/releases/download/tip/master.darwin-amd64.tmp.tar.gz
 39 | 
 40 | # for both
 41 | rm -rf /tmp/golang-tip && tar -C /tmp -xzf master.tmp.tar.gz
 42 | /tmp/golang-tip/bin/go env
 43 | ```
 44 | 
 45 | ## Using golang-tip in GitHub Actions
 46 | 
 47 | Examples for using golang-tip in a GitHub Action.
 48 | 
 49 | ### .tar.gz
 50 | 
 51 | > This example shows how to use golang-tip's .tar.gz release format
 52 | within a GitHub Actions runner. We first purge an existing Go installation.
 53 | If you are looking to save on Actions minutes, this workflow takes
 54 | less than half the time to run as the container example below.
 55 | 
 56 | ```yaml
 57 | # Remove existing Go installation, install golang-tip from latest .tar.gz
 58 | # More .tar.gz releases can be found here: https://github.com/AlekSi/golang-tip/releases/tag/tip
 59 | 
 60 | # action.yml
 61 | ---
 62 | name: Go unit tests with golang-tip
 63 | on:
 64 |   pull_request:
 65 | jobs:
 66 |   test-my-app-targz:
 67 |     name: test my golang app using golang-tip .tar.gz release
 68 |     runs-on: ubuntu-latest
 69 |     steps:
 70 |       - name: Remove existing go installation from Actions runner
 71 |         run: |
 72 |           sudo rm -fr /opt/hostedtoolcache/go /usr/local/go /usr/bin/go /bin/go
 73 |       - name: Install latest golang-tip on Actions runner
 74 |         run: |
 75 |           curl -o go.tar.gz -L \
 76 |             https://github.com/AlekSi/golang-tip/releases/download/tip/master.linux-amd64.tar.gz
 77 |           sudo tar -C /usr/local -xzf go.tar.gz
 78 |           sudo ln -s /usr/local/go/bin/* /usr/local/bin/
 79 |       - uses: actions/checkout@v2
 80 |       - name: run tests
 81 |         run: go test ./...
 82 | ```
 83 | 
 84 | ### Container image
 85 | 
 86 | > This example shows how you can use golang-tip's prebuilt container image
 87 | directly within your GitHub Action Workflow. All `steps` are executed within
 88 | the container image at `ghcr.io/aleksi/golang-tip:master` for the `test-my-app`
 89 | Job.
 90 | 
 91 | ```yaml
 92 | # Run your Job within latest golang-tip built container.
 93 | # Use head of golang-tip aka "master" or other available image tags here:
 94 | # https://github.com/AlekSi/golang-tip/pkgs/container/golang-tip
 95 | 
 96 | # action.yml
 97 | ---
 98 | name: Go unit tests with golang-tip
 99 | on:
100 |   pull_request:
101 | jobs:
102 |   test-my-app-oci:
103 |     name: test my golang app using golang-tip container release
104 |     runs-on: ubuntu-latest
105 |     container:
106 |       image: ghcr.io/aleksi/golang-tip:master
107 |     steps:
108 |       - uses: actions/checkout@v2
109 |       - name: run tests
110 |         run: go test ./...
111 | ```
112 | 
113 | # Branches
114 | 
115 | Currently built branches (see [here](https://github.com/AlekSi/golang-tip/blob/main/.github/workflows/build.yml)):
116 | * `master` a.k.a tip, the next Go version.
117 | * `release-branch.go1.24`
118 | * `release-branch.go1.23`
119 | 
120 | # Docker
121 | 
122 | Docker images are based on the latest stable Go image. The development version completely replaces stable Go in `/usr/local/go`.
123 | `GOLANG_VERSION` environment variable is set to the branch name.
124 | 
125 | ```dockerfile
126 | FROM aleksi/golang-tip:master
127 | ```
128 | 
129 | or
130 | 
131 | ```dockerfile
132 | FROM ghcr.io/aleksi/golang-tip:master
133 | ```
134 | 
135 | 
136 | # .tar.gz
137 | 
138 | `.tar.gz` files are provided in two variants. The main one behaves like [the official Go release](https://golang.org/doc/install) -
139 | it is expected to be unpacked into `/usr/local` as `/usr/local/go`:
140 | 
141 | ```sh
142 | rm -rf /usr/local/go && tar -C /usr/local -xzf master.linux-amd64.tar.gz
143 | ```
144 | 
145 | The variant with `.tmp` in the file name is expected to be unpacked into `/tmp` as `/tmp/golang-tip` (that's the value of [GOROOT_FINAL](https://golang.org/doc/install/source#environment) set during compilation):
146 | 
147 | ```sh
148 | rm -rf /tmp/golang-tip && tar -C /tmp -xzf master.linux-amd64.tmp.tar.gz
149 | ```
150 | 
151 | That allows that version to co-exist with other versions of Go and be installed without additional privileges.
152 | 
153 | 
154 | # Credits
155 | 
156 | Made by Alexey Palazhchenko.
157 | 
158 | Inspired by [go-tip by Craig Peterson](https://github.com/captncraig/go-tip).
159 | 
160 | 
161 | # Contributing
162 | 
163 | Pull requests that add other branches, base Docker images, OSes, and CPU architectures are welcome.
164 | 


--------------------------------------------------------------------------------