Docker Installation

Instructions to setup environment using SoraEngine's docker container.

Docker Desktop is a one-click-install application for your Mac, Linux, or Windows environment that lets you build, share, and run containerized applications and microservices.

It provides a straightforward GUI (Graphical User Interface) that lets you manage your containers, applications, and images directly from your machine.

Docker Desktop reduces the time spent on complex setups so you can focus on writing code. It takes care of port mappings, file system concerns, and other default settings, and is regularly updated with bug fixes and security updates.

Install using following links-

• Windows

• linux

Install Docker Desktop on Windows

Install interactively

1. Download the installer using the download button at the top of the page, or from the release notes.

2. Double-click Docker Desktop Installer.exe to run the installer. By default, Docker Desktop is installed at C:\Program Files\Docker\Docker.

3. When prompted, ensure the Use WSL 2 instead of Hyper-V option on the Configuration page is selected or not depending on your choice of backend.

   If your system only supports one of the two options, you won't be able to select which backend to use.

4. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.

5. When the installation is successful, select Close to complete the installation process.

6. Start Docker Desktop.

Install Docker Desktop on Linux

Recommended approach to install Docker Desktop on Ubuntu:

1. Set up Docker's package repository. See step one of Install using the apt repository.

2. Download the latest DEB package. For checksums, see the Release notes.

3. Install the package with apt as follows:

   $ sudo apt-get update
   $ sudo apt-get install ./docker-desktop-amd64.deb

   Note

   At the end of the installation process, apt displays an error due to installing a downloaded package. You can ignore this error message.

   N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

   By default, Docker Desktop is installed at /opt/docker-desktop.

There are a few post-install configuration steps done through the post-install script contained in the deb package.

The post-install script:

• Sets the capability on the Docker Desktop binary to map privileged ports and set resource limits.

• Adds a DNS name for Kubernetes to /etc/hosts.

• Creates a symlink from /usr/local/bin/com.docker.cli to /usr/bin/docker. This is because the classic Docker CLI is installed at /usr/bin/docker. The Docker Desktop installer also installs a Docker CLI binary that includes cloud-integration capabilities and is essentially a wrapper for the Compose CLI, at/usr/local/bin/com.docker.cli. The symlink ensures that the wrapper can access the classic Docker CLI.

To pull a Docker image from an Amazon ECR repository

1. Authenticate your Docker client to the Amazon ECR registry that you intend to pull your image from. Authentication tokens must be obtained for each registry used, and the tokens are valid for 12 hours. For more information, see Private registry authentication in Amazon ECR.

2. (Optional) Identify the image to pull.

   • You can list the repositories in a registry with the aws ecr describe-repositories command:

     aws ecr describe-repositories

     The example registry above has a repository called sorachain/v1sdk.

   • You can describe the images within a repository with the aws ecr describe-images command:

     aws ecr describe-images --repository-name sorachain/v1sdk
     

     The example repository above has an image tagged as latest and 2016.09, with the image digest sha256:7a395b46e8ce026eee8cd5faf2574177b0136779f0b0b8463b390df793bc8a70.

3. Pull the image using the docker pull command. The image name format should be registry/repository[:tag] to pull by tag, or registry/repository[@digest] to pull by digest.

   docker pull aws_account_id.dkr.ecr.us-east-1.amazonaws.com/sorachain/v1sdk:latest

   Important

   If you receive a repository-url not found: does not exist or no pull access error, you might need to authenticate your Docker client with Amazon ECR. For more information, see Private registry authentication in Amazon ECR.

---