Skip to content

Commit

Permalink
Document port mapping instead
Browse files Browse the repository at this point in the history
  • Loading branch information
pgporada committed May 24, 2024
1 parent 94f0b15 commit dcdab58
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 6 deletions.
3 changes: 0 additions & 3 deletions Dockerfile.release
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,5 @@ ENTRYPOINT [ "/app.exe" ]

# Final stage: dynamically select between Linux and Windows stages based on TARGETOS argument
FROM ${TARGETOS} AS final
# Ports needed for testing when not using docker compose.
EXPOSE 14000
EXPOSE 15000
# Add test configuration files
COPY ./test/ /test/
13 changes: 10 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ at `https://localhost:14000/dir`.

Pebble includes a [docker-compose](https://docs.docker.com/compose/) file that
will create a `pebble` instance that uses a `pebble-challtestsrv` instance for
DNS resolution.
DNS resolution with the correct ports mapped to the host system.

To download and start the containers run:

Expand All @@ -119,6 +119,13 @@ See the [pebble-challtestsrv
README](https://github.com/letsencrypt/pebble/blob/master/cmd/pebble-challtestsrv/README.md)
for more information.

If you are running a one-off container for either `pebble` or
`pebble-challtestsrv`, you will need to manually map ports.
```
docker run -p 14000:14000 -p 15000:15000 ghcr.io/letsencrypt/pebble:latest
docker run -p 5001:5001 -p 5002:5002 -p 5003:5003 -p 8053:8053 -p 8055:8055 -p 8443:8443 ghcr.io/letsencrypt/pebble-challtestsrv:latest
```

#### Prebuilt Docker Images

Pebble releases are published as Docker images to the
Expand All @@ -145,9 +152,9 @@ services:
With a Docker command:
```bash
docker run -e "PEBBLE_VA_NOSLEEP=1" ghcr.io/letsencrypt/pebble
docker run -p 14000:14000 -p 15000:15000 -e "PEBBLE_VA_NOSLEEP=1" ghcr.io/letsencrypt/pebble
# or
docker run -e "PEBBLE_VA_NOSLEEP=1" --mount src=$(pwd)/my-pebble-config.json,target=/test/my-pebble-config.json,type=bind ghcr.io/letsencrypt/pebble pebble -config /test/my-pebble-config.json
docker run -p 14000:14000 -p 15000:15000 -e "PEBBLE_VA_NOSLEEP=1" --mount src=$(pwd)/my-pebble-config.json,target=/test/my-pebble-config.json,type=bind ghcr.io/letsencrypt/pebble pebble -config /test/my-pebble-config.json
```

### Default validation ports
Expand Down

0 comments on commit dcdab58

Please sign in to comment.