Skip to content

Commit

Permalink
docs: update docs for 3.6.0
Browse files Browse the repository at this point in the history
  • Loading branch information
soulteary committed Sep 2, 2024
1 parent 9481067 commit e7667fa
Show file tree
Hide file tree
Showing 3 changed files with 35 additions and 24 deletions.
28 changes: 17 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,28 +20,32 @@ Generate self-hosted or development certificates through simple configuration.
Create self-signed certificates supporting `*.lab.com` and `*.data.lab.com` domains with just **"One Click"**:

```bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.5.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com"
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.6.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com"
# OR use environment:
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" soulteary/certs-maker:v3.5.0
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" soulteary/certs-maker:v3.6.0
```

The generated certificates will be stored in the `ssl` directory within the execution directory:

```bash
ssl
├── lab.com.conf
├── lab.com.crt
└── lab.com.key
├── lab.com.der.crt
├── lab.com.der.key
├── lab.com.pem.crt
└── lab.com.pem.key
```

You can use PEM or DER format certificates according to your preference.

For those who prefer file-based configuration, you can use a `docker-compose.yml` file like this:

```yaml
version: '2'
services:

certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
volumes:
Expand All @@ -59,9 +63,9 @@ docker-compose up
To make the certificate more Kubernetes-friendly, add the `FOR_K8S` parameter:

```bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.5.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_K8S=ON"
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.6.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_K8S=ON"
# OR
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_K8S=ON" soulteary/certs-maker:v3.5.0
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_K8S=ON" soulteary/certs-maker:v3.6.0
```

Here's a K8s-friendly `docker-compose.yml` file:
Expand All @@ -71,7 +75,7 @@ version: '2'
services:

certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
- FOR_K8S=ON
Expand All @@ -82,9 +86,9 @@ certs-maker:
To enhance compatibility with Firefox, include the `FOR_FIREFOX` parameter:

```bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.5.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_FIREFOX=ON"
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.6.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_FIREFOX=ON"
# OR
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_FIREFOX=ON" soulteary/certs-maker:v3.5.0
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_FIREFOX=ON" soulteary/certs-maker:v3.6.0
```

And here's a Firefox-friendly `docker-compose.yml` file:
Expand All @@ -94,7 +98,7 @@ version: '2'
services:

certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
- FOR_FIREFOX=ON
Expand Down Expand Up @@ -124,6 +128,7 @@ Using environment variables:
| File Owner User | USER | `USER=ubuntu` |
| File Owner UID | UID | `UID=1234` |
| File Owner GID | GID | `GID=2345` |
| Expire Days | EXPIRE_DAYS | `EXPIRE_DAYS=3650` |

Using program CLI arguments:

Expand All @@ -141,6 +146,7 @@ Using program CLI arguments:
| File Owner User | USER | `--USER=ubuntu` |
| File Owner UID | UID | `--UID=1234` |
| File Owner GID | GID | `--GID=2345` |
| Expire Days | EXPIRE_DAYS | `--EXPIRE_DAYS=3650` |

## Docker Image

Expand Down
29 changes: 17 additions & 12 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,28 +16,32 @@
如果你本地已经安装好 Docker 或者 CTR,那么可以通过一条命令快速生成包含 `*.lab.com``*.data.lab.com` 的证书:

```bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.5.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com"
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.6.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com"
# 如果你希望使用 ENV 来调整生成证书的参数
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" soulteary/certs-maker:v3.5.0
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" soulteary/certs-maker:v3.6.0
```

在命令执行完毕之后,我们检查执行命令的 `ssl` 就能看到生成的证书文件啦:

```bash
ssl
├── lab.com.conf
├── lab.com.crt
└── lab.com.key
├── lab.com.der.crt
├── lab.com.der.key
├── lab.com.pem.crt
└── lab.com.pem.key
```

你可以根据自己的喜好,使用 PEM 或者 DER 格式的证书。

如果你更喜欢使用配置文件来生成证书,可以使用下面这个 `docker-compose.yml`

```yaml
version: '2'
services:

certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
volumes:
Expand All @@ -55,9 +59,9 @@ docker-compose up
如果你希望生成证书对 K8s 使用体验更友好,可以添加 `FOR_K8S` 参数:

```bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.5.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_K8S=ON"
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.6.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_K8S=ON"
#
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_K8S=ON" soulteary/certs-maker:v3.5.0
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_K8S=ON" soulteary/certs-maker:v3.6.0
```

当然,这里也有使用 `FOR_K8S` 参数的 `compose` 配置文件:
Expand All @@ -67,7 +71,7 @@ version: '2'
services:

certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
- FOR_K8S=ON
Expand All @@ -78,9 +82,9 @@ certs-maker:
如果你希望生成证书对 Firefox 的使用体验更友好,可以添加 `FOR_FIREFOX` 参数:

```bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.5.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_FIREFOX=ON"
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker:v3.6.0 "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_FIREFOX=ON"
#
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_FIREFOX=ON" soulteary/certs-maker:v3.5.0
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_FIREFOX=ON" soulteary/certs-maker:v3.6.0
```

当然,这里也有使用 `FOR_FIREFOX` 参数的 `compose` 配置文件:
Expand All @@ -90,7 +94,7 @@ version: '2'
services:

certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
- FOR_FIREFOX=ON
Expand Down Expand Up @@ -120,7 +124,7 @@ certs-maker:
| File Owner User | USER | `USER=ubuntu` |
| File Owner UID | UID | `UID=1234` |
| File Owner GID | GID | `GID=2345` |

| Expire Days | EXPIRE_DAYS | `EXPIRE_DAYS=3650` |

使用命令行参数:

Expand All @@ -138,6 +142,7 @@ certs-maker:
| File Owner User | USER | `--USER=ubuntu` |
| File Owner UID | UID | `--UID=1234` |
| File Owner GID | GID | `--GID=2345` |
| Expire Days | EXPIRE_DAYS | `--EXPIRE_DAYS=3650` |

## Docker 镜像发布地址

Expand Down
2 changes: 1 addition & 1 deletion docker-compose.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
version: "2"
services:
certs-maker:
image: soulteary/certs-maker:v3.5.0
image: soulteary/certs-maker:v3.6.0
environment:
- CERT_DNS=lab.com,*.lab.com,*.data.lab.com
volumes:
Expand Down

0 comments on commit e7667fa

Please sign in to comment.