Questions and answers about Container Registry

Why is the latesttag missing or why is it assigned to a Docker image that wasn't the last one pushed?

The reason is that you specified a different tag when pushing the Docker image.

The Docker client assigns the latest tag automatically if the Docker image is created and pushed without a tag. You can also specify the latest tag explicitly.

We don't recommend overwriting tags. Use a unique tag for each Docker image version. This way you can use the same Docker image version on all your VMs with identical specifications and more easily identify causes of problems.

How do I make a registry public?

You can issue the container-registry.images.puller role for your registry to the allUsers system group.

I encountered an error. What should I do?

See Troubleshooting in Container Registry. It lists common errors and ways to solve them.

Can I get logs of my operations with services?

Yes, you can request log records about your resources from Yandex Cloud services. For more information, see Data requests.

What does the "Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock" error mean?

You're not running commands as a root user.

You can use sudo or configure non-root access.

How do I diagnose Credential Helper performance?

• Check under which OS user and on which host the CLI commands are run. This must be the user that the Credential Helper is configured for and on whose behalf the yc container registry configure-docker command was run. The corresponding line must appear in the file /home/<user>/.docker/config.json. If you are working on a virtual machine, make sure you have the Credential helper configured there as well.

• Check if the Credential Helper is displayed in PATH when running commands. During authentication in Container Registry using the Credential Helper, Docker accesses the docker-credential-yc binary file. Make sure this binary file is available in PATH for the user working with Docker. For example, if Docker is used with sudo, then configure-docker must be run with sudo, too. You can check this with the echo cr.yandex | docker-credential-yc get command or with echo cr.yandex | sudo docker-credential-yc get if you're running commands with sudo. If everything is working, you'll get a response in the format {"Username":"iam","Secret":"***<iam-token>***"}.

• If the commands run in interactive mode but fail in non-interactive mode, check the .bashrc file. The yc and docker-credential-yc programs are installed in a directory that is not usually available in the default PATH. In this case, the following lines are added to the .bashrc file:

  # The next line updates PATH for Yandex Cloud CLI
  if [ -f '/home/<user>/yandex-cloud/path.bash.inc' ]; then source '/home/<user>/yandex-cloud/path.bash.inc'; fi
  

  The top section of the .bashrc file contains a condition preventing its commands from running non-interactively. That's why the commands can run when connecting to the VM manually, but fail to run when doing so via SSH.