[PR #7367] [CLOSED] New script: Local Certificate Authority based upon Smallstep's step-ca #6784

Closed
opened 2026-02-26 15:33:02 +03:00 by kerem · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/community-scripts/ProxmoxVE/pull/7367
Author: @reelsense
Created: 9/3/2025
Status: Closed

Base: mainHead: step-ca


📝 Commits (6)

📊 Changes

3 files changed (+244 additions, -0 deletions)

View changed files

ct/alpine-step-ca.sh (+48 -0)
frontend/public/json/step-ca.json (+36 -0)
install/alpine-step-ca-install.sh (+160 -0)

📄 Description

✍️ Description

Thanks to @fwiegerinck: This pull request refactors and fixes the previously closed PR #1655 for the Smallstep step-ca script. The original submission was not merged due to non-compliance with the project's contribution standards.

This new version addresses all feedback from the original PR thread:

  • Correct Script Structure: The interactive whiptail setup dialogs have been moved from ct/alpine-step-ca.sh into install/alpine-step-ca-install.sh, as requested. The ct script now correctly serves only to define container variables and initiate the build.
  • Safe Update Handling: The previous, unsafe update_script has been replaced with the standard "no-update" function. This aligns with updateable: false in the JSON file and prevents users from accidentally breaking their CA with a simple package upgrade.
  • Code Standardization: The installation script has been overhauled to use the project's standard functions (msg_info, msg_ok) and variables ($STD) for consistent output and behavior.
  • Improved User Experience: The final MOTD message now correctly displays the CA fingerprint and ACME URL (if enabled) to guide the user on how to start using their new CA.

These changes bring the script set into full compliance with the contribution guidelines, making it safe, maintainable, and ready for merging.

Fixes and supersedes #1655

Prerequisites (X in brackets)

  • Self-review completed – Code follows project standards.
  • Tested thoroughly – Changes work as expected.
  • No security risks – No hardcoded secrets, unnecessary privilege escalations, or permission issues.

🛠️ Type of Change (X in brackets)

  • 🐞 Bug fix – Resolves an issue without breaking functionality.
  • New feature – Adds new, non-breaking functionality.
  • 💥 Breaking change – Alters existing functionality in a way that may require updates.
  • 🆕 New script – A fully functional and tested script or script set.
  • 🌍 Website update – Changes to website-related JSON files or metadata.
  • 🔧 Refactoring / Code Cleanup – Improves readability or maintainability without changing functionality.
  • 📝 Documentation update – Changes to README, AppName.md, CONTRIBUTING.md, or other docs.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/community-scripts/ProxmoxVE/pull/7367 **Author:** [@reelsense](https://github.com/reelsense) **Created:** 9/3/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `step-ca` --- ### 📝 Commits (6) - [`daf39ed`](https://github.com/community-scripts/ProxmoxVE/commit/daf39edb1f4f22d92902205191dfcb8d9637e447) Create alpine-step-ca.sh - [`033fce3`](https://github.com/community-scripts/ProxmoxVE/commit/033fce377b402f8f9b7a5ef47c600515419f95fa) Create alpine-step-ca-install.sh - [`99ca754`](https://github.com/community-scripts/ProxmoxVE/commit/99ca7546c977972222d0f56734e866e325eb192c) Create step-ca.json - [`81884a8`](https://github.com/community-scripts/ProxmoxVE/commit/81884a8fd2223195891151417e34aa8db754f39c) alpine 3.22 - [`be5a321`](https://github.com/community-scripts/ProxmoxVE/commit/be5a321f76703dacfaf9e6822e544f2803f48528) alpine 3.22 - [`a594aa2`](https://github.com/community-scripts/ProxmoxVE/commit/a594aa2b55d41c1ac3718547aeb5f5419f7b5b1a) fix(step-ca): Use correct DNS name for initial policy ### 📊 Changes **3 files changed** (+244 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `ct/alpine-step-ca.sh` (+48 -0) ➕ `frontend/public/json/step-ca.json` (+36 -0) ➕ `install/alpine-step-ca-install.sh` (+160 -0) </details> ### 📄 Description <!--🛑 New scripts must be submitted to [ProxmoxVED](https://github.com/community-scripts/ProxmoxVED) for testing. PRs without prior testing will be closed. --> ## ✍️ Description Thanks to @fwiegerinck: This pull request refactors and fixes the previously closed PR #1655 for the Smallstep `step-ca` script. The original submission was not merged due to non-compliance with the project's contribution standards. This new version addresses all feedback from the original PR thread: - **Correct Script Structure:** The interactive `whiptail` setup dialogs have been moved from `ct/alpine-step-ca.sh` into `install/alpine-step-ca-install.sh`, as requested. The `ct` script now correctly serves only to define container variables and initiate the build. - **Safe Update Handling:** The previous, unsafe `update_script` has been replaced with the standard "no-update" function. This aligns with `updateable: false` in the JSON file and prevents users from accidentally breaking their CA with a simple package upgrade. - **Code Standardization:** The installation script has been overhauled to use the project's standard functions (`msg_info`, `msg_ok`) and variables (`$STD`) for consistent output and behavior. - **Improved User Experience:** The final MOTD message now correctly displays the CA fingerprint and ACME URL (if enabled) to guide the user on how to start using their new CA. These changes bring the script set into full compliance with the contribution guidelines, making it safe, maintainable, and ready for merging. ## 🔗 Related PR / Issue Fixes and supersedes #1655 ## ✅ Prerequisites (**X** in brackets) - [X] **Self-review completed** – Code follows project standards. - [X] **Tested thoroughly** – Changes work as expected. - [X] **No security risks** – No hardcoded secrets, unnecessary privilege escalations, or permission issues. --- ## 🛠️ Type of Change (**X** in brackets) - [X] 🐞 **Bug fix** – Resolves an issue without breaking functionality. - [ ] ✨ **New feature** – Adds new, non-breaking functionality. - [ ] 💥 **Breaking change** – Alters existing functionality in a way that may require updates. - [X] 🆕 **New script** – A fully functional and tested script or script set. - [ ] 🌍 **Website update** – Changes to website-related JSON files or metadata. - [X] 🔧 **Refactoring / Code Cleanup** – Improves readability or maintainability without changing functionality. - [ ] 📝 **Documentation update** – Changes to `README`, `AppName.md`, `CONTRIBUTING.md`, or other docs. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
kerem 2026-02-26 15:33:02 +03:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/ProxmoxVE#6784
No description provided.