Skip to content

Commit 1939b9e

Browse files
committed
docs: v1.5.0
1 parent 73595a9 commit 1939b9e

File tree

7 files changed

+28
-28
lines changed

7 files changed

+28
-28
lines changed

Makefile

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
NAME = osixia/openldap
2-
VERSION = 1.4.0
2+
VERSION = 1.5.0
33

44
.PHONY: build build-nocache test tag-latest push push-latest release git-tag-version
55

README.md

+22-22
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
[![Docker Stars](https://img.shields.io/docker/stars/osixia/openldap.svg)](https://hub.docker.com/r/osixia/openldap/)
55
[![Layers](https://images.microbadger.com/badges/image/osixia/openldap.svg)](https://hub.docker.com/r/osixia/openldap/)
66

7-
Latest release: 1.4.0 - [OpenLDAP 2.4.50](https://www.openldap.org/software/release/changes.html) - [Changelog](CHANGELOG.md) | [Docker Hub](https://hub.docker.com/r/osixia/openldap/) 
7+
Latest release: 1.5.0 - [OpenLDAP 2.4.50](https://www.openldap.org/software/release/changes.html) - [Changelog](CHANGELOG.md) | [Docker Hub](https://hub.docker.com/r/osixia/openldap/) 
88

99
**A docker image to run OpenLDAP.**
1010

@@ -39,7 +39,7 @@ Latest release: 1.4.0 - [OpenLDAP 2.4.50](https://www.openldap.org/software/rele
3939
- [Docker Secrets](#docker-secrets)
4040
- [Make your own image or extend this image](#make-your-own-image-or-extend-this-image)
4141
- [Advanced User Guide](#advanced-user-guide)
42-
- [Extend osixia/openldap:1.4.0 image](#extend-osixiaopenldap140-image)
42+
- [Extend osixia/openldap:1.5.0 image](#extend-osixiaopenldap150-image)
4343
- [Make your own openldap image](#make-your-own-openldap-image)
4444
- [Tests](#tests)
4545
- [Kubernetes](#kubernetes)
@@ -60,13 +60,13 @@ If you find this image useful here's how you can help:
6060
Run OpenLDAP docker image:
6161

6262
```sh
63-
docker run --name my-openldap-container --detach osixia/openldap:1.4.0
63+
docker run --name my-openldap-container --detach osixia/openldap:1.5.0
6464
```
6565

6666
Do not forget to add the port mapping for both port 389 and 636 if you wish to access the ldap server from another machine.
6767

6868
```sh
69-
docker run -p 389:389 -p 636:636 --name my-openldap-container --detach osixia/openldap:1.4.0
69+
docker run -p 389:389 -p 636:636 --name my-openldap-container --detach osixia/openldap:1.5.0
7070
```
7171

7272
Either command starts a new container with OpenLDAP running inside. Let's make the first search in our LDAP container:
@@ -109,7 +109,7 @@ docker run \
109109
--env LDAP_ORGANISATION="My Company" \
110110
--env LDAP_DOMAIN="my-company.com" \
111111
--env LDAP_ADMIN_PASSWORD="JonSn0w" \
112-
--detach osixia/openldap:1.4.0
112+
--detach osixia/openldap:1.5.0
113113
```
114114

115115
#### Data persistence
@@ -174,12 +174,12 @@ argument to entrypoint if you don't want to overwrite them.
174174
# single file example:
175175
docker run \
176176
--volume ./bootstrap.ldif:/container/service/slapd/assets/config/bootstrap/ldif/50-bootstrap.ldif \
177-
osixia/openldap:1.4.0 --copy-service
177+
osixia/openldap:1.5.0 --copy-service
178178

179179
# directory example:
180180
docker run \
181181
--volume ./ldif:/container/service/slapd/assets/config/bootstrap/ldif/custom \
182-
osixia/openldap:1.4.0 --copy-service
182+
osixia/openldap:1.5.0 --copy-service
183183
```
184184

185185
#### Seed from internal path
@@ -213,7 +213,7 @@ simply mount this directories as a volume to `/var/lib/ldap` and `/etc/ldap/slap
213213
docker run \
214214
--volume /data/slapd/database:/var/lib/ldap \
215215
--volume /data/slapd/config:/etc/ldap/slapd.d \
216-
--detach osixia/openldap:1.4.0
216+
--detach osixia/openldap:1.5.0
217217
```
218218

219219
You can also use data volume containers. Please refer to:
@@ -235,7 +235,7 @@ If you are looking for a simple solution to administrate your ldap server you ca
235235
By default, TLS is already configured and enabled, certificate is created using container hostname (it can be set by docker run --hostname option eg: ldap.example.org).
236236

237237
```sh
238-
docker run --hostname ldap.my-company.com --detach osixia/openldap:1.4.0
238+
docker run --hostname ldap.my-company.com --detach osixia/openldap:1.5.0
239239
```
240240

241241
#### Use your own certificate
@@ -249,25 +249,25 @@ docker run \
249249
--env LDAP_TLS_CRT_FILENAME=my-ldap.crt \
250250
--env LDAP_TLS_KEY_FILENAME=my-ldap.key \
251251
--env LDAP_TLS_CA_CRT_FILENAME=the-ca.crt \
252-
--detach osixia/openldap:1.4.0
252+
--detach osixia/openldap:1.5.0
253253
```
254254

255255
Other solutions are available please refer to the [Advanced User Guide](#advanced-user-guide)
256256

257257
#### Disable TLS
258258
Add --env LDAP_TLS=false to the run command:
259259

260-
docker run --env LDAP_TLS=false --detach osixia/openldap:1.4.0
260+
docker run --env LDAP_TLS=false --detach osixia/openldap:1.5.0
261261

262262
### Multi master replication
263263
Quick example, with the default config.
264264

265265
#Create the first ldap server, save the container id in LDAP_CID and get its IP:
266-
LDAP_CID=$(docker run --hostname ldap.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.4.0)
266+
LDAP_CID=$(docker run --hostname ldap.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.5.0)
267267
LDAP_IP=$(docker inspect -f "{{ .NetworkSettings.IPAddress }}" $LDAP_CID)
268268

269269
#Create the second ldap server, save the container id in LDAP2_CID and get its IP:
270-
LDAP2_CID=$(docker run --hostname ldap2.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.4.0)
270+
LDAP2_CID=$(docker run --hostname ldap2.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.5.0)
271271
LDAP2_IP=$(docker inspect -f "{{ .NetworkSettings.IPAddress }}" $LDAP2_CID)
272272

273273
#Add the pair "ip hostname" to /etc/hosts on each containers,
@@ -303,7 +303,7 @@ You may have some problems with mounted files on some systems. The startup scrip
303303

304304
To fix that run the container with `--copy-service` argument :
305305

306-
docker run [your options] osixia/openldap:1.4.0 --copy-service
306+
docker run [your options] osixia/openldap:1.5.0 --copy-service
307307

308308
### Debug
309309

@@ -313,13 +313,13 @@ Available levels are: `none`, `error`, `warning`, `info`, `debug` and `trace`.
313313
Example command to run the container in `debug` mode:
314314

315315
```sh
316-
docker run --detach osixia/openldap:1.4.0 --loglevel debug
316+
docker run --detach osixia/openldap:1.5.0 --loglevel debug
317317
```
318318

319319
See all command line options:
320320

321321
```sh
322-
docker run osixia/openldap:1.4.0 --help
322+
docker run osixia/openldap:1.5.0 --help
323323
```
324324

325325
## Environment Variables
@@ -386,7 +386,7 @@ Replication options:
386386

387387
If you want to set this variable at docker run command add the tag `#PYTHON2BASH:` and convert the yaml in python:
388388

389-
docker run --env LDAP_REPLICATION_HOSTS="#PYTHON2BASH:['ldap://ldap.example.org','ldap://ldap2.example.org']" --detach osixia/openldap:1.4.0
389+
docker run --env LDAP_REPLICATION_HOSTS="#PYTHON2BASH:['ldap://ldap.example.org','ldap://ldap2.example.org']" --detach osixia/openldap:1.5.0
390390

391391
To convert yaml to python online: https://yaml-online-parser.appspot.com/
392392

@@ -413,7 +413,7 @@ docker run \
413413
--env LDAP_ORGANISATION="My company" \
414414
--env LDAP_DOMAIN="my-company.com" \
415415
--env LDAP_ADMIN_PASSWORD="JonSn0w" \
416-
--detach osixia/openldap:1.4.0
416+
--detach osixia/openldap:1.5.0
417417
```
418418

419419
Be aware that environment variable added in command line will be available at any time
@@ -427,7 +427,7 @@ For example if your environment files **my-env.yaml** and **my-env.startup.yaml*
427427
```sh
428428
docker run \
429429
--volume /data/ldap/environment:/container/environment/01-custom \
430-
--detach osixia/openldap:1.4.0
430+
--detach osixia/openldap:1.5.0
431431
```
432432

433433
Take care to link your environment files folder to `/container/environment/XX-somedir` (with XX < 99 so they will be processed before default environment files) and not directly to `/container/environment` because this directory contains predefined baseimage environment files to fix container environment (INITRD, LANG, LANGUAGE and LC_CTYPE).
@@ -437,7 +437,7 @@ Note: the container will try to delete the **\*.startup.yaml** file after the en
437437
```sh
438438
docker run \
439439
--volume /data/ldap/environment/my-env.yaml:/container/environment/01-custom/env.yaml \
440-
--detach osixia/openldap:1.4.0
440+
--detach osixia/openldap:1.5.0
441441
```
442442

443443
#### Docker Secrets
@@ -463,14 +463,14 @@ This is the best solution if you have a private registry. Please refer to the [A
463463

464464
## Advanced User Guide
465465

466-
### Extend osixia/openldap:1.4.0 image
466+
### Extend osixia/openldap:1.5.0 image
467467

468468
If you need to add your custom TLS certificate, bootstrap config or environment files the easiest way is to extends this image.
469469

470470
Dockerfile example:
471471

472472
```dockerfile
473-
FROM osixia/openldap:1.4.0
473+
FROM osixia/openldap:1.5.0
474474
LABEL maintainer="Your Name <[email protected]>"
475475
476476
ADD bootstrap /container/service/slapd/assets/config/bootstrap

example/docker-compose.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
version: '2'
22
services:
33
openldap:
4-
image: osixia/openldap:1.4.0
4+
image: osixia/openldap:1.5.0
55
container_name: openldap
66
environment:
77
LDAP_LOG_LEVEL: "256"

example/extend-osixia-openldap/Dockerfile

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
FROM osixia/openldap:1.4.0
1+
FROM osixia/openldap:1.5.0
22
MAINTAINER Your Name <[email protected]>
33

44
ADD bootstrap /container/service/slapd/assets/config/bootstrap

example/kubernetes/simple/ldap-deployment.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ spec:
1616
spec:
1717
containers:
1818
- name: ldap
19-
image: osixia/openldap:1.4.0
19+
image: osixia/openldap:1.5.0
2020
volumeMounts:
2121
- name: ldap-data
2222
mountPath: /var/lib/ldap

example/kubernetes/using-secrets/gce-statefullset.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ spec:
1212
spec:
1313
containers:
1414
- name: azaldap
15-
image: osixia/openldap:1.4.0
15+
image: osixia/openldap:1.5.0
1616
imagePullPolicy: IfNotPresent
1717
#command: ["/bin/bash","-c","while [ 1 = 1 ] ; do sleep 1; date; done"]
1818
ports:

example/kubernetes/using-secrets/ldap-deployment.yaml.example

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ spec:
1616
spec:
1717
containers:
1818
- name: ldap
19-
image: osixia/openldap:1.4.0
19+
image: osixia/openldap:1.5.0
2020
args: ["--copy-service"]
2121
volumeMounts:
2222
- name: ldap-data

0 commit comments

Comments
 (0)