Moghedrin dc00376c80 Resolve merge issue 11 years ago
..
.keep 48776166e3 adding some directories for andrew to dump the short and long desc in 11 years ago
README-content.md 1561546c56 Minor fixes to several readmes, and fixed ruby readme to be consistent with the other scripting languages. 11 years ago
README-short.txt 0bfa713d79 Added basic documentation for the go container. More advanced usage to come. 11 years ago
README.md dc00376c80 Resolve merge issue 11 years ago
logo.png 01c1265395 logos for all the things 11 years ago

README-content.md

What is Go?

Go, also called golang, is a programming language initially developed at Google in 2007 by Robert Griesemer, Rob Pike, and Ken Thompson. It is a statically-typed language with syntax loosely derived from that of C, adding garbage collection, type safety, some dynamic-typing capabilities, additional built-in types such as variable-length arrays and key-value maps, and a large standard library.

[http://en.wikipedia.org/wiki/Go_(programming_language)]

How to use this image

Start a go instance running in your app.

For this image, the most straight-forward use is to use a golang container as both the build environment as well as the runtime environment. In your Dockerfile, you can do something along the lines of the following will compile and run your project.

FROM golang
ADD . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN go build
CMD ["./myapp"]

Then run and build the docker image.

docker build -t my-golang-app
docker run -it --rm --name my-running-app my-golang-app

Compile your app inside the docker container.

It is not always appropriate to run your app inside a container. In instances where you only want to compile inside the docker instance, you can do something along the lines of the following.

docker run --rm -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp golang go build

This will add your current directory as a volume to the comtainer, set the working directory to the volume, and run the command go build which will tell go to compile the project in the working directory and output the executable to myapp. Alternatively, if you have a make file, you can instead run the make command inside your container.

docker run --rm -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp make