https://github.com/polyconseil/grocker

Grocker, docker image builder
https://github.com/polyconseil/grocker

docker python

Last synced: 11 months ago
JSON representation

Grocker, docker image builder

• Host: GitHub
• URL: https://github.com/polyconseil/grocker
• Owner: Polyconseil
• License: other
• Created: 2015-04-27T08:05:18.000Z (about 11 years ago)
• Default Branch: main
• Last Pushed: 2024-02-27T14:28:45.000Z (over 2 years ago)
• Last Synced: 2025-06-09T08:16:34.407Z (about 1 year ago)
• Topics: docker, python
• Language: Python
• Homepage:
• Size: 513 KB
• Stars: 10
• Watchers: 34
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
Grocker - a Docker image builder for Python applications

========================================================

*Grocker* allows you to bundle your Python applications as Docker image

while keeping the image size as minimal as possible.

*Grocker* uses ``debian:buster``, ``debian:bookworm`` or ``alpine:latest`` as its

base image.

*Grocker* is hosted on Github at https://github.com/polyconseil/Grocker.

*Grocker* full documentation is available on https://grocker.readthedocs.io/.

Installation

============

1. Install Docker Engine. See `its official documentation `_.

2. Install Grocker with *pip*: ``pip install grocker``.

Basic usage

===========

.. code-block:: console

    $ grocker build ipython==5.0.0 --entrypoint ipython

    $ docker run --rm -ti ipython:5.0.0-

Direct wheel path

=================

A wheel can also be directly passed to grocker to avoid the need to upload an artefact to

build an image.

Grocker will switch to this mode if a ``/`` is present in the argument. Pip ``extra``

requirements can be used in this mode.

.. code-block:: console

    $ grocker build ./path/to/ipython-7.1.1-py3-none-any.whl[doc] --entrypoint ipython

    $ docker run --rm -ti ipython-doc:7.1.1-