Skip to content

Commit

Permalink
Update Go example to use "go.mod"
Browse files Browse the repository at this point in the history
tianon committed Feb 4, 2022
1 parent 05f7d81 commit 0d46dc0
Showing 1 changed file with 9 additions and 6 deletions.
15 changes: 9 additions & 6 deletions golang/content.md
Original file line number Diff line number Diff line change
@@ -8,20 +8,23 @@ Go (a.k.a., Golang) is a programming language first developed at Google. It is a

# How to use this image

**Note:** `/go` is world-writable to allow flexibility in the user which runs the container (for example, in a container started with `--user 1000:1000`, running `go get github.com/example/...` will succeed). While the `777` directory would be insecure on a regular host setup, there are not typically other processes or users inside the container, so this is equivilant to `700` for Docker usage, but allowing for `--user` flexibility.
**Note:** `/go` is world-writable to allow flexibility in the user which runs the container (for example, in a container started with `--user 1000:1000`, running `go get github.com/example/...` into the default `$GOPATH` will succeed). While the `777` directory would be insecure on a regular host setup, there are not typically other processes or users inside the container, so this is equivalent to `700` for Docker usage, but allowing for `--user` flexibility.

## Start a Go instance in your app

The most straightforward way to use this image is to use a Go container as both the build and runtime environment. In your `Dockerfile`, writing something along the lines of the following will compile and run your project:
The most straightforward way to use this image is to use a Go container as both the build and runtime environment. In your `Dockerfile`, writing something along the lines of the following will compile and run your project (assuming it uses `go.mod` for dependency management):

```dockerfile
FROM %%IMAGE%%:1.17

WORKDIR /go/src/app
COPY . .
WORKDIR /usr/src/app

# pre-copy/cache go.mod for pre-downloading dependencies and only redownloading them in subsequent builds if they change
COPY go.mod go.sum ./
RUN go mod download && go mod verify

RUN go get -d -v ./...
RUN go install -v ./...
COPY . .
RUN go build -v -o /usr/local/bin/app ./...

CMD ["app"]
```

0 comments on commit 0d46dc0

Please sign in to comment.