Code Monkey home page Code Monkey logo

docker_registry_cli's Introduction

Gem Version

WAT?#

This cli-tool lets you query your private docker registry for different things and delete them. **docker_registry_cli is yet build/tested on osx only **

Features

  1. List/Delete images and/or tags
  2. Supports Basic Auth and Bearer Token Auth which are used by projects like Docker-Auth or Portus
  3. Supports credential helper (preferred) and config.json auth (plain text auth, so will be removed in the future)

Installation#

gem install docker_registry_cli

Usage#

For help see

docker_registry_cli --help

Examples###

List all repositories:

docker_registry_cli list

nginx php php7 percona

List all repositories:

docker_registry_cli search php

php php7

docker_registry_cli tags nginx

latest

Delete a tag

docker_registry_cli delete_tag someimage sometag

Delete a image

docker_registry_cli delete_image someimage

Configuration#

To ease up your usage, you can add some configuration

  1. If you did yet not do so (you will have..), login into your registry using your local docker. docker login <yourdomain> This creates a ~/.docker/config.json. From docker 1.11 it will be automatically using the credential helper:

In any way you should always use the credential helper, see here

Be aware, unless you use a credentials helper, your user/password is saved plain-text!

Alternatively (not recommended): Provide user and password on each cli call

  1. optionally, define a default domain echo "domain: <yourdomain>\n" > ~/.docker_registry.yml This defines the default domain to query for

Advanced

Deleting images

If you want to delete images, be sure to enable storage->delete->true in your registry-installation config.yml, see https://github.com/docker/distribution/blob/master/docs/configuration.md

Limitations#

  • HTTPS only (i consider HTTP to be a bug)

Contribute#

Happy to merge in pull requests!

docker_registry_cli's People

Contributors

aboettger-tuhh avatar eugenmayer avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.