From 29d189b581042b6842b16a7c6f8377e33ef36e42 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Miloslav=20Trma=C4=8D?= Date: Sat, 11 Jun 2016 03:20:27 +0200 Subject: [PATCH 1/2] Recommend (make check) instead of (make test-integration) ... so that we also run validate-* and unit tests. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index dae082a8..5889dda3 100644 --- a/README.md +++ b/README.md @@ -112,7 +112,7 @@ Tests - _You need Docker installed on your system in order to run the test suite_ ```sh -$ make test-integration +$ make check ``` TODO - From 55622350c446f15549e0feec31a0cfbd1488c21b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Miloslav=20Trma=C4=8D?= Date: Sat, 11 Jun 2016 03:33:23 +0200 Subject: [PATCH 2/2] Show (skopeo copy) and (skopeo delete) in README.md --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5889dda3..c1514c95 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,11 @@ skopeo [![Build Status](https://travis-ci.org/projectatomic/skopeo.svg?branch=ma _Please be aware `skopeo` is still work in progress and it currently supports only registry API V2_ -`skopeo` is a command line utility which is able to _inspect_ a repository on a Docker registry and fetch images layers. +`skopeo` is a command line utility for various operations on container images and image repositories. + +Inspecting a repository +- +`skopeo` is able to _inspect_ a repository on a Docker registry and fetch images layers. By _inspect_ I mean it fetches the repository's manifest and it is able to show you a `docker inspect`-like json output about a whole repository or a tag. This tool, in contrast to `docker inspect`, helps you gather useful information about a repository or a tag before pulling it (using disk space) - e.g. - which tags are available for the given repository? which labels the image has? @@ -41,6 +45,24 @@ $ skopeo inspect docker://docker.io/fedora:rawhide | jq '.Digest' "sha256:905b4846938c8aef94f52f3e41a11398ae5b40f5855fb0e40ed9c157e721d7f8" ``` +Copying images +- +`skopeo` can copy container images between various storage mechansism, +e.g. Docker registries (including the Docker Hub), the Atomic Registry, +and local directories: + +```sh +$ skopeo copy docker://busybox:1-glibc atomic:myns/unsigned:streaming +$ skopeo copy docker://busybox:latest dir:existingemptydirectory +``` + +Deleting images +- +For example, +```sh +$ skopeo delete docker://localhost:5000/imagename:latest +``` + Private registries with authentication - When interacting with private registries, `skopeo` first looks for the Docker's cli config file (usually located at `$HOME/.docker/config.json`) to get the credentials needed to authenticate. When the file isn't available it falls back looking for `--username` and `--password` flags. The ultimate fallback, as Docker does, is to provide an empty authentication when interacting with those registries.