https://github.com/whalecold/docker-drag

https://github.com/whalecold/docker-drag

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/whalecold/docker-drag
• Owner: whalecold
• Created: 2020-08-15T13:42:58.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-08-15T13:43:19.000Z (over 4 years ago)
• Last Synced: 2024-10-14T17:51:31.459Z (3 months ago)
• Language: Python
• Size: 7.81 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# docker-drag

This repository contains Python scripts for interacting with Docker Hub or other registries, without needing the Docker client itself.

It relies on the Docker registry [HTTPS API v2](https://docs.docker.com/registry/spec/api/).

## Pull a Docker image in HTTPS

`python docker_pull.py hello-world`

`python docker_pull.py mysql/mysql-server:8.0`

`python docker_pull.py mcr.microsoft.com/mssql-tools`

`python docker_pull.py consul@sha256:6ba4bfe1449ad8ac5a76cb29b6c3ff54489477a23786afb61ae30fb3b1ac0ae9`



  



## Limitations

- Only support v2 manifests: some registries, like quay.io which only uses v1 manifests, may not work.

## Well known bugs

2 open bugs which shouldn't affect the efficiency of the script nor the pulled image:

- Unicode content (for example `\u003c`) gets automatically decoded by `json.loads()` which differs from the original Docker client behaviour (`\u003c` should not be decoded when creating the TAR file). This is due to the json Python library automatically converting string to unicode.

- Fake layers ID are not calculated the same way than Docker client does (I don't know yet how layer hashes are generated, but it seems deterministic and based on the client)

## fork from https://github.com/NotGlop/docker-drag