@@ -43,29 +43,41 @@ Install with pip
4343
4444 pip install python-gitlab
4545
46+ Using the docker image
47+ ======================
4648
47- Using the python-gitlab docker image
48- ====================================
49+ You can run the Docker image directly from the GitLab registry:
4950
50- How to build
51- ------------
51+ ..code-block ::console
52+
53+ $ docker run -it --rm registry.gitlab.com/python-gitlab/python-gitlab:latest <command> ...
54+
55+ For example, to get a project on GitLab.com (without authentication):
56+
57+ ..code-block ::console
5258
53- `` dockerbuild -t python-gitlab:TAG . ``
59+ $ dockerrun -it --rm registry.gitlab.com/ python-gitlab/python-gitlab:latest project get --id gitlab-org/gitlab
5460
55- How to use
56- ----------
61+ You can also mount your own config file:
5762
58- ``docker run -it --rm -e GITLAB_PRIVATE_TOKEN=<your token> -v /path/to/python-gitlab.cfg:/python-gitlab.cfg python-gitlab <command> ... ``
63+ ..code-block ::console
64+
65+ $ docker run -it --rm -v /path/to/python-gitlab.cfg:/etc/python-gitlab.cfg registry.gitlab.com/python-gitlab/python-gitlab:latest <command> ...
66+
67+ Building the image
68+ ------------------
5969
60- or run it directly fromthe upstream image :
70+ To build your own image fromthis repository, run :
6171
62- ``docker run -it --rm -e GITLAB_PRIVATE_TOKEN=<your token> -v /path/to/python-gitlab.cfg:/python-gitlab.cfg registry.gitlab.com/python-gitlab/python-gitlab:latest <command> ... ``
72+ ..code-block ::console
73+
74+ $ docker build -t python-gitlab:latest .
6375
64- To change the GitLab URL, use ` -e GITLAB_URL=< yoururl> `
76+ Run yourown image:
6577
66- Bring your own config file:
67- ``docker run -it --rm -v /path/to/python-gitlab.cfg:/python-gitlab.cfg -e GITLAB_CFG=/python-gitlab.cfg python-gitlab <command> ... ``
78+ ..code-block ::console
6879
80+ $ docker run -it --rm -v python-gitlab:latest <command> ...
6981
7082 Bug reports
7183===========