install-go/README.md
jake 55cb2b2be5
Some checks failed
test / test (push) Failing after 3s
adding version input, adjusting tests
2025-05-22 21:49:48 -04:00

29 lines
1.7 KiB
Markdown

# install-go
![tests](https://code.jakeyoungdev.com/actions/install-go/actions/workflows/test.yaml/badge.svg?branch=main&event=push) <br />
An extremely simple github action to install golang and golang commands (using "go install") on linux hosts. This provides the ability to install and setup golang without node/typescript which is required when using [actions/setup-go](https://github.com/actions/setup-go).
## Usage
Use a tagged release to avoid unexpected changes that may come to the master branch
```yaml
name: "install go"
uses: https://code.jakeyoungdev.com/actions/install-go@master
with:
commands: |
code.jakeyoungdev.com/jake/mctl@v0.3.3
```
#### Go verions
The Go version installed is determined by the version specified in the go.mod file. If not mod file is present the 'version' input is used. Go files are pulled directly from the Go download [site](https://go.dev/dl/) and all go commands are installed using 'go install' after setup. If a different version of Go is already installed the 'purge' input must be set to 'yes' to remove it and avoid errors.
#### Inputs
Some inputs are available to customize the installation
|Input|Required|Values|Default|Description|
|---|---|---|---|---|
|arch|no|any arch for Go|amd64|system architecture for go
|purge|no|yes/no|no|remove any go files found on system before install
|commands|no|any public go repositories|.|links to any commands to be installed using 'go install'
|version|no|any go version|.|the go version to use if no mod file is present
## Issues
This repo is a as brain-dead as I could make it and is intended to be as fast and low-level as possible. Please open an issue for any problems or suggestions.