diff --git a/assets/style.css b/assets/style.css index 7ad4fa7b7..d014653b2 100644 --- a/assets/style.css +++ b/assets/style.css @@ -1135,6 +1135,19 @@ div, span, html, body, ul, article, main, nav { min-width: 0; } +/* Tutorials disclaimer */ +[id="tutorial_disclaimer"] { + background-color: var(--color-sc-gray-4); + border-radius: 8px; + margin: calc(var(--spacing) * 12) + 0 + calc(var(--spacing) * 18) + 0; + padding: calc(var(--spacing) * 6) + calc(var(--spacing) * 4) + calc(var(--spacing) * 6) + calc(var(--spacing) * 8); +} ol.deploy-timeline { border-left: 4px solid var(--color-primary-gray-200); diff --git a/src/_includes/icons/keycloak.svg b/src/_includes/icons/keycloak.svg new file mode 100644 index 000000000..878570687 --- /dev/null +++ b/src/_includes/icons/keycloak.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/src/_includes/tutorial_disclaimer.md b/src/_includes/tutorial_disclaimer.md new file mode 100644 index 000000000..f800938ea --- /dev/null +++ b/src/_includes/tutorial_disclaimer.md @@ -0,0 +1,64 @@ +
+## Disclaimer + +This tutorial provides guidance based on approaches that are generally +considered effective and aligned with common industry practices. However, it +reflects a generalized perspective and may not be fully suitable for every +environment or use case. + +While care has been taken to follow recognized best practices, the actual +implementation will depend on your specific infrastructure, constraints, and +requirements. **You remain solely responsible for evaluating, adapting, and +applying the instructions appropriately in your context**. + +We strive to keep this content accurate and up to date. Nevertheless, +technologies, dependencies, and security standards evolve over time, and we +cannot guarantee that all information remains current or error-free. + +All commands, configuration snippets, and examples are provided for +illustrative purposes only. They are not intended to be used verbatim in +production without proper review, testing, and adaptation.\\ +**Final implementation decisions and their consequences are the responsibility +of the user**. + +### Responsibilities + +This tutorial describes a self-managed deployment approach and does not +constitute a managed or hosted service provided by Scalingo. + +Scalingo remains responsible for the buildpacks, the scripts, initial +configuration, samples, and instructions presented in this tutorial. + +Operational responsibility, including, but not limited to deployment, final +configurations, proper exploitation, maintenance, upgrades, monitoring, +backup restoration tests and security, remains with the user. + +### Security Notice + +Proper security practices are essential when deploying software: +- **Always use strong, unique passwords** for all services and accounts. +- **Do not reuse credentials** across systems. +- Prefer long passphrases (at least 16 characters) combining letters, numbers, + and symbols. +- **Store credentials securely** (e.g., password managers, secret management + tools) and **never hardcode them in source code or configuration files**. + +Here is an example command to generate a strong password from the command line: +```bash +openssl rand -base64 24 +``` + +Alternatively: +```bash +head -c 32 /dev/urandom | base64 +``` + +### Feedback and Contributions + +If you identify an error, outdated information, or missing details, +contributions are welcome. You may get in touch with our Support Team, [open an +issue](https://github.com/Scalingo/documentation/issues), or [submit a pull +request](https://github.com/Scalingo/documenation/pulls). + +Your feedback helps improve the quality and reliability of this documentation. +
diff --git a/src/_layouts/tutorials_page.html b/src/_layouts/tutorials_page.html index d89acad98..a04641f22 100644 --- a/src/_layouts/tutorials_page.html +++ b/src/_layouts/tutorials_page.html @@ -28,6 +28,7 @@