diff --git a/golang/README.md b/golang/README.md index 26149b0d5..70e4728d7 100644 --- a/golang/README.md +++ b/golang/README.md @@ -118,20 +118,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 golang:1.17 -WORKDIR /go/src/app -COPY . . +WORKDIR /usr/src/app -RUN go get -d -v ./... -RUN go install -v ./... +# 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 + +COPY . . +RUN go build -v -o /usr/local/bin/app ./... CMD ["app"] ``` diff --git a/nats/README.md b/nats/README.md index 4338f99f7..c794a7736 100644 --- a/nats/README.md +++ b/nats/README.md @@ -28,20 +28,20 @@ WARNING: ## Simple Tags -- [`2.7.1-alpine3.15`, `2.7-alpine3.15`, `2-alpine3.15`, `alpine3.15`, `2.7.1-alpine`, `2.7-alpine`, `2-alpine`, `alpine`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/alpine3.15/Dockerfile) -- [`2.7.1-scratch`, `2.7-scratch`, `2-scratch`, `scratch`, `2.7.1-linux`, `2.7-linux`, `2-linux`, `linux`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/scratch/Dockerfile) -- [`2.7.1-windowsservercore-1809`, `2.7-windowsservercore-1809`, `2-windowsservercore-1809`, `windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/windowsservercore-1809/Dockerfile) -- [`2.7.1-nanoserver-1809`, `2.7-nanoserver-1809`, `2-nanoserver-1809`, `nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/nanoserver-1809/Dockerfile) +- [`2.7.2-alpine3.15`, `2.7-alpine3.15`, `2-alpine3.15`, `alpine3.15`, `2.7.2-alpine`, `2.7-alpine`, `2-alpine`, `alpine`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/alpine3.15/Dockerfile) +- [`2.7.2-scratch`, `2.7-scratch`, `2-scratch`, `scratch`, `2.7.2-linux`, `2.7-linux`, `2-linux`, `linux`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/scratch/Dockerfile) +- [`2.7.2-windowsservercore-1809`, `2.7-windowsservercore-1809`, `2-windowsservercore-1809`, `windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/windowsservercore-1809/Dockerfile) +- [`2.7.2-nanoserver-1809`, `2.7-nanoserver-1809`, `2-nanoserver-1809`, `nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/nanoserver-1809/Dockerfile) ## Shared Tags -- `2.7.1`, `2.7`, `2`, `latest`: - - [`2.7.1-scratch`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/scratch/Dockerfile) - - [`2.7.1-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/nanoserver-1809/Dockerfile) -- `2.7.1-windowsservercore`, `2.7-windowsservercore`, `2-windowsservercore`, `windowsservercore`: - - [`2.7.1-windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/windowsservercore-1809/Dockerfile) -- `2.7.1-nanoserver`, `2.7-nanoserver`, `2-nanoserver`, `nanoserver`: - - [`2.7.1-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/1bad0202ccd16901e1bd359731b25f658f60848f/2.7.1/nanoserver-1809/Dockerfile) +- `2.7.2`, `2.7`, `2`, `latest`: + - [`2.7.2-scratch`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/scratch/Dockerfile) + - [`2.7.2-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/nanoserver-1809/Dockerfile) +- `2.7.2-windowsservercore`, `2.7-windowsservercore`, `2-windowsservercore`, `windowsservercore`: + - [`2.7.2-windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/windowsservercore-1809/Dockerfile) +- `2.7.2-nanoserver`, `2.7-nanoserver`, `2-nanoserver`, `nanoserver`: + - [`2.7.2-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/4edda137e008eeca00abfda368971f64f597644b/2.7.2/nanoserver-1809/Dockerfile) # Quick reference (cont.) diff --git a/photon/README.md b/photon/README.md index b416f3b65..3315c5cab 100644 --- a/photon/README.md +++ b/photon/README.md @@ -26,8 +26,8 @@ WARNING: - [`4.0`, `4.0-20220128`, `latest`](https://github.com/vmware/photon-docker-image/blob/8afc93f902c5f7adb9e962e27af6c3036e0b8610/docker/Dockerfile) - [`3.0`, `3.0-20220128`](https://github.com/vmware/photon-docker-image/blob/bc5831f060bc7ec60baa821b39af6b7f641ed935/docker/Dockerfile) -- [`1.0`, `1.0-20220128`](https://github.com/vmware/photon-docker-image/blob/b5b4ae64d58456bcca75ab0a14eef46c4e322007/docker/Dockerfile) -- [`2.0`, `2.0-20220128`](https://github.com/vmware/photon-docker-image/blob/5c7c46e3bb1ddd85be7e24098b2012db8d5eb8bf/docker/Dockerfile) +- [`1.0`, `1.0-20220204`](https://github.com/vmware/photon-docker-image/blob/aff3d2c827e9245fc28921860f457d8df0e1f205/docker/Dockerfile) +- [`2.0`, `2.0-20220204`](https://github.com/vmware/photon-docker-image/blob/367b8a26f71905d041460d2920e4830eba8201f8/docker/Dockerfile) # Quick reference (cont.) diff --git a/ros/README.md b/ros/README.md index b3fc76ffa..ff33d51cb 100644 --- a/ros/README.md +++ b/ros/README.md @@ -44,7 +44,7 @@ WARNING: - [`galactic-ros1-bridge`, `galactic-ros1-bridge-focal`](https://github.com/osrf/docker_images/blob/8c7ec280db9c754aa163e84bf70f4cbb902e69fb/ros/galactic/ubuntu/focal/ros1-bridge/Dockerfile) - [`rolling-ros-core`, `rolling-ros-core-focal`](https://github.com/osrf/docker_images/blob/11c613986e35a1f36fd0fa18b49173e0c564cf1d/ros/rolling/ubuntu/focal/ros-core/Dockerfile) - [`rolling-ros-base`, `rolling-ros-base-focal`, `rolling`](https://github.com/osrf/docker_images/blob/a5644adacdca4a49faf10221620048175cdd7262/ros/rolling/ubuntu/focal/ros-base/Dockerfile) -- [`rolling-ros1-bridge`, `rolling-ros1-bridge-focal`](https://github.com/osrf/docker_images/blob/8c7ec280db9c754aa163e84bf70f4cbb902e69fb/ros/rolling/ubuntu/focal/ros1-bridge/Dockerfile) +- [`rolling-ros1-bridge`, `rolling-ros1-bridge-focal`](https://github.com/osrf/docker_images/blob/e471aedbeaee1e0309bfe5dd1f2e8eea45f1adac/ros/rolling/ubuntu/focal/ros1-bridge/Dockerfile) # Quick reference (cont.)