Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/udhos/update-golang

update-golang is a script to easily fetch and install new Golang releases with minimum system intrusion
https://github.com/udhos/update-golang

go golang script shell

Last synced: 1 day ago
JSON representation

update-golang is a script to easily fetch and install new Golang releases with minimum system intrusion

Host: GitHub
URL: https://github.com/udhos/update-golang
Owner: udhos
License: mit
Created: 2017-04-10T21:50:01.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-06-25T01:05:35.000Z (6 months ago)
Last Synced: 2024-11-20T21:20:51.845Z (23 days ago)
Topics: go, golang, script, shell
Language: Shell
Homepage:
Size: 127 KB
Stars: 1,857
Watchers: 29
Forks: 229
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-tools - update-golang.sh
awesome-golang-repositories - update-golang - golang is a script to easily fetch and install new Golang releases with minimum system intrusion (Repositories)

README

        [![license](http://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/udhos/update-golang/blob/master/LICENSE)

[![Travis Build Status](https://travis-ci.org/udhos/update-golang.svg?branch=master)](https://travis-ci.org/udhos/update-golang)

# update-golang

update-golang is a script to easily fetch and install new Golang releases with minimum system intrusion.

Table of Contents

=================

  * [How it works](#how-it-works)

  * [Usage](#usage)

  * [Caution](#caution)

  * [Remove](#remove)

  * [Example](#example)

  * [Customization](#customization)

  * [Per\-user Install](#per-user-install)

Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc.go)

How it works

============

The script is based on official installation instructions from https://go.dev/doc/install.

This is the default behavior:

1\. Search for the latest binary release in https://go.dev/dl/.

2\. The script uses local system OS and ARCH to download the correct binary release. It is not harmful to run the script multiple times. Downloaded releases are kept as cache under '/usr/local'. You can erase them manually.

By default, the script only detects actual releases (not beta releases, not release candidates). However one can force any specific non-final release:

    $ # force specific release candidate

    $ sudo RELEASE=1.11rc1 ./update-golang.sh

3\. The release is installed at '/usr/local/go'.

4\. The path '/usr/local/go/bin' is added to PATH using '/etc/profile.d/golang_path.sh'.

5\. Only if needed, GOROOT is properly setup, also using '/etc/profile.d/golang_path.sh'.

The script DOES NOT ever modify the GOPATH variable.

You can customize the behavior by setting environment variables (see Customization below).

Usage

=====

    git clone https://github.com/udhos/update-golang

    cd update-golang

    sudo ./update-golang.sh

Caution

=======

Before running the script, make sure you have an untampered copy by verifying the SHA256 checksum.

    $ wget -qO hash.txt https://raw.githubusercontent.com/udhos/update-golang/master/update-golang.sh.sha256

    $ sha256sum -c hash.txt

    update-golang.sh: OK

Remove

======

You can use the 'remove' option to undo update-golang.sh work:

    $ sudo ./update-golang.sh remove

Declutter

======

You can use the '-declutter' option to prevent caching downloaded archives:

    $ sudo ./update-golang.sh -declutter

Example

=======

Sample session:

    lab@ubu1:~$ go

    The program 'go' can be found in the following packages:

     * golang-go

     * gccgo-go

    Try: sudo apt install 

    lab@ubu1:~$

    lab@ubu1:~$ git clone https://github.com/udhos/update-golang

    Cloning into 'update-golang'...

    remote: Counting objects: 481, done.

    remote: Compressing objects: 100% (11/11), done.

    remote: Total 481 (delta 4), reused 9 (delta 2), pack-reused 468

    Receiving objects: 100% (481/481), 70.22 KiB | 125.00 KiB/s, done.

    Resolving deltas: 100% (248/248), done.

    lab@ubu1:~$

    lab@ubu1:~$ cd update-golang

    lab@ubu1:~/update-golang$ sudo ./update-golang.sh

    update-golang.sh: version 0.15

    update-golang.sh: find_latest: found last release: 1.10.2

    update-golang.sh: user: uid=0(root) gid=0(root) groups=0(root)

    update-golang.sh: RELEASE_LIST=https://golang.org/doc/devel/release.html

    update-golang.sh: SOURCE=https://storage.googleapis.com/golang

    update-golang.sh: DESTINATION=/usr/local

    update-golang.sh: RELEASE=1.10.2

    update-golang.sh: OS=linux

    update-golang.sh: ARCH_PROBE=uname -m

    update-golang.sh: ARCH=amd64

    update-golang.sh: PROFILED=/etc/profile.d/golang_path.sh

    update-golang.sh: CACHE=/usr/local

    update-golang.sh: GOPATH=

    update-golang.sh: DEBUG=

    update-golang.sh: will install golang go1.10.2.linux-amd64 as: /usr/local/go

    update-golang.sh: https://storage.googleapis.com/golang/go1.10.2.linux-amd64.tar.gz is remote

    update-golang.sh: no need to download - file cached: /usr/local/go1.10.2.linux-amd64.tar.gz

    update-golang.sh: remove_old_link: not found symlink for old install

    update-golang.sh: untar: tar -x -f /usr/local/go1.10.2.linux-amd64.tar.gz

    update-golang.sh: path: removing old settings from: /etc/profile.d/golang_path.sh

    update-golang.sh: path: issuing new /usr/local/go/bin to /etc/profile.d/golang_path.sh

    update-golang.sh: path: issuing /home/lab/go/bin to /etc/profile.d/golang_path.sh

    update-golang.sh: golang go1.10.2.linux-amd64 installed at: /usr/local/go

    update-golang.sh: testing: /usr/local/go/bin/go version

    update-golang.sh: go version go1.10.2 linux/amd64

    update-golang.sh: /usr/local/go/bin/go version: SUCCESS

    update-golang.sh: testing: /usr/local/go/bin/go run /tmp/hello-tmpv1bX1rQN.go

    update-golang.sh: hello, world

    update-golang.sh: /usr/local/go/bin/go run /tmp/hello-tmpv1bX1rQN.go: SUCCESS

    update-golang.sh: cleanup: /tmp/tmp.tcNY25eXNl

    lab@ubu1:~/update-golang$

Customization

=============

These environment variables are available for customization:

    RELEASE_LIST=https://golang.org/doc/devel/release.html ;# search for new releases from this url

    SOURCE=https://storage.googleapis.com/golang           ;# download source location

    DESTINATION=/usr/local                                 ;# install destination

    RELEASE=1.8.3                                          ;# force golang release

    OS=linux                                               ;# force os

    ARCH_PROBE='uname -m'                                  ;# force arch detection command

    ARCH=amd64                                             ;# force arch

    PROFILED=/etc/profile.d/golang_path.sh                 ;# update PATH, optionally set GOROOT

    CACHE=/usr/local                                       ;# cache downloads in this dir

    GOPATH=                                                ;# use this GOPATH

    DEBUG=                                                 ;# set to enable debug

Example:

    $ sudo RELEASE=1.9beta1 ./update-golang.sh

Per-user Install

================

Default behavior is to install Golang globally for all system users.

However you can use the environment variables to point locations to your per-user home directory.

The per-user installation does not need root (sudo) privileges.

Example installing:

    This example will install Golang under ~/golang for current user only.

    

    $ mkdir ~/golang

    $ DESTINATION=~/golang PROFILED=~/.bash_profile ./update-golang.sh

Example uninstalling:

    To uninstall, make sure to provide the same env vars used for installing:

    $ DESTINATION=~/golang PROFILED=~/.bash_profile ./update-golang.sh remove

END