https://github.com/larsks/undocker

https://github.com/larsks/undocker

Last synced: 9 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/larsks/undocker
• Owner: larsks
• License: gpl-3.0
• Created: 2015-02-13T02:23:56.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2022-11-15T21:58:04.000Z (almost 2 years ago)
• Last Synced: 2024-04-24T15:19:24.264Z (7 months ago)
• Language: Python
• Size: 32.2 KB
• Stars: 303
• Watchers: 9
• Forks: 54
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
Unpacks a Docker image.

## Usage

    usage: undocker.py [-h] [--ignore-errors] [--output OUTPUT] [--verbose]

                       [--debug] [--list] [--layer LAYER]

                       image

    positional arguments:

      image

    optional arguments:

      -h, --help            show this help message and exit

      --ignore-errors, -i   Ignore OS errors when extracting files

      --output OUTPUT, -o OUTPUT

                            Output directory (defaults to ".")

      --verbose, -v

      --debug, -d

      --list, --ls          List layers in an image

      --layer LAYER, -l LAYER

                            Extract only the specified layer

## Examples

Extract an entire image:

    $ docker save busybox | undocker -i -o busybox busybox

The `-i` option is necessary here because I am not running as root,

and the extract operation will fail when it attempts to create device

nodes.

List the layers in an image:

    $ docker save busybox | undocker --list

    511136ea3c5a64f264b78b5433614aec563103b4d4702f3ba7d4d2698e22c158

    df7546f9f060a2268024c8a230d8639878585defcc1bc6f79d2728a13957871b

    ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2

    4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125

Extract only specific layers:

    $ docker save busybox |

      undocker -o busybox -v \

      -l 4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125 \

      busybox

    INFO:undocker:extracting image busybox (4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125)

    INFO:undocker:extracting layer 4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125

## License

undocker -- a tool for decomposing Docker images  

Copyright (C) 2015 Lars Kellogg-Stedman 

This program is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.

This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.

You should have received a copy of the GNU General Public License

along with this program.  If not, see .