mirror of
https://github.com/w2c/letsencrypt-esxi.git
synced 2026-01-13 22:21:31 -06:00
89 lines
3.8 KiB
Markdown
89 lines
3.8 KiB
Markdown
# Build w2c-letsencrypt-esxi VIB & Offline Bundle
|
|
|
|
The `build.sh` bash script includes the commands needed to generate the VIB and Offline Bundle files. It relies on the [lamw/vibauthor](https://hub.docker.com/r/lamw/vibauthor/) Docker container and uses the files in this repository.
|
|
|
|
After copying all files to the container, `create_vib.sh` runs in the container to actually build the ESXi bundle.
|
|
|
|
Here is a sample output of the script:
|
|
|
|
```bash
|
|
/bin/bash ./build.sh
|
|
|
|
Untagged: letsencrypt-esxi:latest
|
|
Deleted: sha256:3009ff3662db9c3b60157bc0fff1a0c936ec6e301103c5efc50eca113c744b5f
|
|
Deleted: sha256:daff819de772ed33d7de07701d8235453872365586a49c503f5194555424cda1
|
|
Deleted: sha256:e0f946d4136a08d7d87bbce58af17226b019cbd97f3fec018861f155ded84257
|
|
Sending build context to Docker daemon 1.261MB
|
|
Step 1/4 : FROM lamw/vibauthor
|
|
---> a673ffe4ba43
|
|
Step 2/4 : COPY . letsencrypt-esxi
|
|
---> 6197d7c06029
|
|
Step 3/4 : RUN /bin/bash letsencrypt-esxi/build/create_vib.sh
|
|
---> Running in 3f6f149cfed4
|
|
WARNING: extensibility rules check failed, but was ignored because of --force.
|
|
VIB (web-wack-creations_bootbank_w2c-letsencrypt-esxi_1.0.0-0.0.0) failed a check of extensibility rules for acceptance level 'community': [u'(line 23: col 0) Element vib failed to validate content'].
|
|
Successfully created w2c-letsencrypt-esxi.vib.
|
|
Successfully created w2c-letsencrypt-esxi-offline-bundle.zip.
|
|
**** Info for VIB: w2c-letsencrypt-esxi.vib ****
|
|
VIB Format: 2.0.0
|
|
VIB ID: web-wack-creations_bootbank_w2c-letsencrypt-esxi_1.0.0-0.0.0
|
|
VIB Type: bootbank
|
|
Name: w2c-letsencrypt-esxi
|
|
Version: 1.0.0-0.0.0
|
|
Vendor: web-wack-creations
|
|
Summary: [Fling] Let's Encrypt for ESXi
|
|
Description: Let's Encrypt for ESXi
|
|
Creation Date: 2022-05-29 15:03:02+00:00
|
|
Provides:
|
|
w2c-letsencrypt-esxi = 1.0.0-0.0.0
|
|
Depends:
|
|
Conflicts:
|
|
Replaces:
|
|
w2c-letsencrypt-esxi << 1.0.0-0.0.0
|
|
Software Tags: []
|
|
MaintenanceMode: remove/update: False, installation: False
|
|
Signed: False
|
|
AcceptanceLevel: community
|
|
LiveInstallAllowed: True
|
|
LiveRemoveAllowed: True
|
|
CimomRestart: False
|
|
StatelessReady: True
|
|
Overlay: False
|
|
Payloads:
|
|
Name Type Boot Size Checksums
|
|
payload1 vgz 0 26555 sha-256 5df898d1217a9167e2e9f7d8e8d2e2a21bcd1acad0f7b74fa9d793c85e728bf3
|
|
sha-1 76834e1ea72f6e306d10a411eccc777faa2e8ddf
|
|
Removing intermediate container 3f6f149cfed4
|
|
---> f2f14c706557
|
|
Step 4/4 : CMD ["/bin/bash"]
|
|
---> Running in fc567d964e69
|
|
Removing intermediate container fc567d964e69
|
|
---> 5c3b069e2f7a
|
|
Successfully built 5c3b069e2f7a
|
|
Successfully tagged letsencrypt-esxi:latest
|
|
```
|
|
|
|
Upon success, there should be a new directory named `artifacts` which contains the resulting VIB and Offline Bundle files.
|
|
|
|
```bash
|
|
ls -l ../artifacts
|
|
|
|
-rw-r--r-- 1 root root 30K May 29 15:04 w2c-letsencrypt-esxi-offline-bundle.zip
|
|
-rw-r--r-- 1 root root 28K May 29 15:04 w2c-letsencrypt-esxi.vib
|
|
```
|
|
|
|
## Possible Pitfalls
|
|
|
|
As the [lamw/vibauthor](https://hub.docker.com/r/lamw/vibauthor/) container builds on CentOS 6, Docker requires a specific `vsyscall` setting to be set in the kernel of the host system that might no longer be the case if a more recent Linux kernel is used. E.g., on a recent version of Debian, running the container will result in a SegFault due to [bug 852620](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=852620). If you encounter this problem, it can be [fixed](https://salsa.debian.org/kernel-team/linux/commit/74f87b226a1267b837d98a5d46824f9b5629962e) by setting `vsyscall=emulate`:
|
|
|
|
`vi /etc/default/grub`
|
|
|
|
```bash
|
|
GRUB_CMDLINE_LINUX_DEFAULT="quiet vsyscall=emulate"
|
|
```
|
|
|
|
```bash
|
|
update-grub
|
|
reboot
|
|
```
|