Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Docker is a tool for creating, running, and managing lightweight virtual machines. These virtual machines make it possible to distribute executable environments with all of the dependencies that can easily be run by others. These Docker images can then be stored and distributed on a Docker registry, a collection of these images. There are a number of open registries on the web, and Synapse hosts a private registry, freely available to our users, which will allow users to create software on a per project basis that can be easily shared across Synapse. Learn more about Docker and Docker registry.

Registered Synapse users interact with the Synapse Docker registry using the standard Docker client. If you have not yet created a Synapse account, please register for Synapse.

In Synapse, Docker containers are represented as versioned ‘repositories’ under the Docker tab. As with Files and Tables, repositories are organized by project and inherit the access permissions from the parent project. Local Sharing Settings can be applied directly to the repository if permissions should differ from the project.

...

Learn more about building docker Docker images.

Storing Docker images in the Synapse Docker registry

...

To access the Docker images stored in Synapse, use the docker pull command. To pull from the Synapse Docker registry, users must be logged into the registry and have download permissions:

Info

Tip: By default, if you do not specify a tag, it will attach latest as the tag. If you specified a tag on your repository, be sure to pull the repository with the tag.

...

Docker tags can be assigned to later commits. If you want to be explicit about the version of an image then instead of referencing a tag you can reference a digest:

Code Block
docker login -u <synapse username> -p <synapse password> docker.synapse.org
docker pull docker.synapse.org/syn12345/mytestrepo@sha256:2e36829f986351042e28242ae386913645a7b41b25844fb39b29af0bdf8dcb63

...