diff --git a/.github/workflows/website.yml b/.github/workflows/website.yml index 73f082ab..0b45aa5f 100644 --- a/.github/workflows/website.yml +++ b/.github/workflows/website.yml @@ -47,6 +47,9 @@ jobs: echo 'staging:' > .asf.yaml echo ' profile: ~' >> .asf.yaml echo ' whoami: asf-site' >> .asf.yaml + echo "" >> .asf.yaml + echo 'publish:' > .asf.yaml + echo ' whoami: asf-site' >> .asf.yaml git add .asf.yaml git commit -m '.asf.yaml' git push origin asf-site diff --git a/docs/introduction.md b/docs/introduction.md index 58a86116..79d86b28 100644 --- a/docs/introduction.md +++ b/docs/introduction.md @@ -29,17 +29,14 @@ Ambari enables Application Developers and System Integrators to: ## Getting Started with Ambari -Follow the [installation guide for Ambari 2.7.6](https://cwiki.apache.org/confluence/display/AMBARI/Installation+Guide+for+Ambari+2.7.6). +Follow the [quick start guide for Ambari 3.0.0](quick-start/quick-start-guide.md). Note: Ambari currently supports the 64-bit version of the following Operating Systems: -* RHEL (Redhat Enterprise Linux) 7.4, 7.3, 7.2 -* CentOS 7.4, 7.3, 7.2 -* OEL (Oracle Enterprise Linux) 7.4, 7.3, 7.2 -* Amazon Linux 2 -* SLES (SuSE Linux Enterprise Server) 12 SP3, 12 SP2 -* Ubuntu 14 and 16 -* Debian 9 +* Rocky Linux 8 +* Rocky Linux 9 +* OpenEuler 22 +* Other operating systems will be supported in future releases. ## Get Involved diff --git a/docs/release-notes.md b/docs/release-notes.md index fdc33900..e43dae79 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -4,12 +4,75 @@ sidebar_position: 2 # Apache Ambari 3.0.0 Release Notes +## Download + +Apache Ambari 3.0.0 can be downloaded from the [Apache Ambari Download Page](https://apache-ambari.com/download/). + ## Overview :::tip Major Release Apache Ambari 3.0.0 represents a significant milestone in the project's development, bringing major improvements to cluster management capabilities, user experience, and platform support. This release focuses on modernizing the technology stack, enhancing security features, and improving overall stability and performance. ::: +## Acknowledgment and Important Notes + +### A Message to Our Community + +:::info Important Transition +We want to acknowledge that Ambari 3.0 represents a significant milestone as the first major release since the HDP project became closed source. Due to this transition, we have made some important decisions: + +- The 2.7.x series has reached End-of-Life (EOL) and will no longer be maintained, as we no longer have access to the HDP packaging source code. +- Version 3.0 marks the beginning of our new mainline branch, which will receive primary maintenance and development focus. +::: + +### From Our Hearts to the Community + +:::note A Journey Together +The path to this release has been long and challenging. Our community has weathered significant changes and obstacles: + +
+ +- 🔄 Community restructuring and transitions +- 👥 A significantly reduced contributor base +- 🛠 Critical infrastructure challenges, especially around RPM distribution +- 🔨 Profound organizational changes + +
+::: + +:::tip Thank You +To every user who has stood by Ambari through these times: your patience and understanding mean more to us than words can express. We know this release has been a long time coming, and we are truly sorry for keeping you waiting. +::: + +:::info With Gratitude +Our hearts are filled with gratitude for: + +
+ +- 🌟 The pioneers who laid Ambari's foundation +- ⭐️ The steadfast contributors who've stayed with us through the storms +- 💫 Every community member whose belief in open source has never wavered + +
+ +This release exists because of your unwavering support and dedication to the open source spirit. Your commitment has been our guiding light through these challenging times. +::: + +### Technical Changes + +#### Apache Bigtop Integration +:::tip New Integration +We are pleased to announce that Ambari 3.0 now uses Apache Bigtop for component packaging: + +
+ +- 📦 [Apache Bigtop](https://github.com/apache/bigtop/) is now our default packaging system +- 🔧 Bigtop Stack serves as the default project stack +- 🚀 This integration provides a more sustainable and community-driven approach to package management + +
+::: + ## Release Highlights ### Major Improvements @@ -24,11 +87,15 @@ For developers interested in compiling components for the Ambari Bigtop Stack, w ### Platform Support -- Added support for Rocky Linux 8 and 9 ([AMBARI-26133](https://issues.apache.org/jira/browse/AMBARI-26133)) -- Added support for openEuler-22.03 ([AMBARI-26126](https://issues.apache.org/jira/browse/AMBARI-26126)) -- Added Java 17 support ([AMBARI-26142](https://issues.apache.org/jira/browse/AMBARI-26142), [AMBARI-26186](https://issues.apache.org/jira/browse/AMBARI-26186)) -- Added MySQL 8 support for Hive ([AMBARI-26130](https://issues.apache.org/jira/browse/AMBARI-26130)) -- Enhanced Docker environment with bigtop/puppet:trunk-rockylinux-8 image +
+ +- ✅ Added support for Rocky Linux 8 and 9 ([AMBARI-26133](https://issues.apache.org/jira/browse/AMBARI-26133)) +- ✅ Added support for openEuler-22.03 ([AMBARI-26126](https://issues.apache.org/jira/browse/AMBARI-26126)) +- ☕️ Added Java 17 support ([AMBARI-26142](https://issues.apache.org/jira/browse/AMBARI-26142), [AMBARI-26186](https://issues.apache.org/jira/browse/AMBARI-26186)) +- 🗄 Added MySQL 8 support for Hive ([AMBARI-26130](https://issues.apache.org/jira/browse/AMBARI-26130)) +- 📈 Enhanced Docker environment with bigtop/puppet:trunk-rockylinux-8 image + +
### New Services and Components @@ -159,7 +226,6 @@ For developers interested in compiling components for the Ambari Bigtop Stack, w - Fixed issue with 'supported-refresh-commands' element ([AMBARI-25863](https://issues.apache.org/jira/browse/AMBARI-25863)) - Reduced excess Zookeeper and Hadoop logging ([AMBARI-24140](https://issues.apache.org/jira/browse/AMBARI-24140)) - - **Bug Fixes**: - Fixed OceanBase support in Ambari MySQL DDL ([AMBARI-26273](https://issues.apache.org/jira/browse/AMBARI-26273)) - Fixed regex pattern flag position in ambari_jinja2 filters ([AMBARI-26269](https://issues.apache.org/jira/browse/AMBARI-26269)) @@ -179,6 +245,71 @@ For developers interested in compiling components for the Ambari Bigtop Stack, w - Fixed alter dispatcher ([AMBARI-26240](https://issues.apache.org/jira/browse/AMBARI-26240)) - Corrected spelling mistakes in documentation ([AMBARI-26104](https://issues.apache.org/jira/browse/AMBARI-26104)) +## Known Issues + +- Timeline Service Reader may fail to start if HBase is not installed ([AMBARI-26248](https://issues.apache.org/jira/browse/AMBARI-26248)) +- Timeline Service v2 may fail to start due to issues with leveldb state store directory creation ([AMBARI-26249](https://issues.apache.org/jira/browse/AMBARI-26249)) +- Some LDAP/AD authentication issues may occur with previously synced users ([AMBARI-26304](https://issues.apache.org/jira/browse/AMBARI-26304)) +- DFSRouter command script path may not be correct ([AMBARI-26116](https://issues.apache.org/jira/browse/AMBARI-26116)) +- Module 'status_params' may have no attribute 'router_pid_file' ([AMBARI-26141](https://issues.apache.org/jira/browse/AMBARI-26141)) +- _threadlocal may have no uid because it is always None ([AMBARI-26241](https://issues.apache.org/jira/browse/AMBARI-26241)) + +## Roadmap + +The Apache Ambari project has an ambitious roadmap for future releases. The following initiatives are planned for upcoming development cycles: + +### Technology Stack Modernization + +- **Spring Framework 6 Upgrade**: Migrate from current Spring version to Spring 6 to leverage the latest features, performance improvements, and security enhancements. +- **Ubuntu Support**: Extend platform compatibility to include Ubuntu, providing more deployment options for users. + +### Deployment and Operations + +- **Docker Automation**: Develop comprehensive Docker-based automation for cluster deployment, making it easier to provision and manage Ambari clusters in containerized environments. +- **Enhanced Containerization**: Improve container orchestration capabilities for both development and production environments. + +### Frontend Modernization + +- **jQuery Bug Fixes**: Continue to address and resolve UI issues resulting from the jQuery upgrade. +- **Micro-Frontend Architecture**: Implement a gradual transition from the current Ember.js framework to React using a micro-frontend approach, allowing for incremental modernization without disrupting existing functionality. +- **UI/UX Improvements**: Enhance the user interface with modern design patterns and improved user experience. + +These roadmap items represent the project's commitment to continuous improvement and adaptation to evolving technologies in the big data ecosystem. Community contributions and feedback on these initiatives are welcome. + +## Upgrading to Apache Ambari 3.0.0 + +:::note + +TODO + +::: + +For detailed instructions on upgrading from previous versions, please refer to the Upgrade Guide. + +## Compatibility Matrix + +| Component | Supported Versions | +|-----------|-------------------| +| Operating Systems | Rocky Linux 8, Rocky Linux 9, openEuler-22.03, CentOS 7.x, RHEL 7.x, RHEL 8.x | +| Java | OpenJDK 8, OpenJDK 11, OpenJDK 17 | +| Database | PostgreSQL 10+, MySQL 5.7+, MySQL 8+, MariaDB 10.2+, OceanBase | +| Browser | Chrome 80+, Firefox 78+, Edge 80+ | + + +## Verification + +It is essential that you verify the integrity of the downloaded files using the PGP signatures and SHA256 checksums. + +```bash +# Verify the SHA256 checksum +sha256sum --check apache-ambari-3.0.0.tar.gz.sha256 + +# Verify the PGP signature +gpg --verify apache-ambari-3.0.0.tar.gz.asc apache-ambari-3.0.0.tar.gz +``` + +The PGP signatures can be verified using the public keys of the Apache Ambari Release Managers, which can be found on the [Apache Ambari Download Page](https://ambari.apache.org/download.html). + ## Acknowledgments :::tip Our Amazing Contributors 🌟 @@ -203,7 +334,6 @@ These dedicated individuals have made substantial contributions to this release: - **timyuer** 🏆 - **yaruyng** 🏆 - **tongxiaojun** 🏆 - ### Community Champions 🌠 Their valuable contributions have helped drive the project forward: @@ -250,69 +380,14 @@ A special note of appreciation goes to our Release Manager(s), whose tireless co Every contribution, no matter how small, helps make Ambari better. We welcome new contributors to join our vibrant community! ::: -## Known Issues - -- Timeline Service Reader may fail to start if HBase is not installed ([AMBARI-26248](https://issues.apache.org/jira/browse/AMBARI-26248)) -- Timeline Service v2 may fail to start due to issues with leveldb state store directory creation ([AMBARI-26249](https://issues.apache.org/jira/browse/AMBARI-26249)) -- Some LDAP/AD authentication issues may occur with previously synced users ([AMBARI-26304](https://issues.apache.org/jira/browse/AMBARI-26304)) -- DFSRouter command script path may not be correct ([AMBARI-26116](https://issues.apache.org/jira/browse/AMBARI-26116)) -- Module 'status_params' may have no attribute 'router_pid_file' ([AMBARI-26141](https://issues.apache.org/jira/browse/AMBARI-26141)) -- _threadlocal may have no uid because it is always None ([AMBARI-26241](https://issues.apache.org/jira/browse/AMBARI-26241)) - -## Roadmap - -The Apache Ambari project has an ambitious roadmap for future releases. The following initiatives are planned for upcoming development cycles: - -### Technology Stack Modernization - -- **Spring Framework 6 Upgrade**: Migrate from current Spring version to Spring 6 to leverage the latest features, performance improvements, and security enhancements. -- **Ubuntu Support**: Extend platform compatibility to include Ubuntu, providing more deployment options for users. - -### Deployment and Operations - -- **Docker Automation**: Develop comprehensive Docker-based automation for cluster deployment, making it easier to provision and manage Ambari clusters in containerized environments. -- **Enhanced Containerization**: Improve container orchestration capabilities for both development and production environments. - -### Frontend Modernization - -- **jQuery Bug Fixes**: Continue to address and resolve UI issues resulting from the jQuery upgrade. -- **Micro-Frontend Architecture**: Implement a gradual transition from the current Ember.js framework to React using a micro-frontend approach, allowing for incremental modernization without disrupting existing functionality. -- **UI/UX Improvements**: Enhance the user interface with modern design patterns and improved user experience. - -These roadmap items represent the project's commitment to continuous improvement and adaptation to evolving technologies in the big data ecosystem. Community contributions and feedback on these initiatives are welcome. - -## Upgrading to Apache Ambari 3.0.0 - -:::note - -TODO - -::: - -For detailed instructions on upgrading from previous versions, please refer to the Upgrade Guide. - -## Compatibility Matrix - -| Component | Supported Versions | -|-----------|-------------------| -| Operating Systems | Rocky Linux 8, Rocky Linux 9, openEuler-22.03, CentOS 7.x, RHEL 7.x, RHEL 8.x | -| Java | OpenJDK 8, OpenJDK 11, OpenJDK 17 | -| Database | PostgreSQL 10+, MySQL 5.7+, MySQL 8+, MariaDB 10.2+, OceanBase | -| Browser | Chrome 80+, Firefox 78+, Edge 80+ | - -## Download - -Apache Ambari 3.0.0 can be downloaded from the [Apache Ambari Download Page](https://ambari.apache.org/download.html). +## Community -## Verification - -It is essential that you verify the integrity of the downloaded files using the PGP signatures and SHA256 checksums. +We welcome your feedback and contributions to Apache Ambari: -```bash -# Verify the SHA256 checksum -sha256sum --check apache-ambari-3.0.0.tar.gz.sha256 +- [Mailing Lists](https://ambari.apache.org/mail-lists.html) +- [Issue Tracker](https://issues.apache.org/jira/projects/AMBARI) +- [GitHub Repository](https://github.com/apache/ambari) -# Verify the PGP signature -gpg --verify apache-ambari-3.0.0.tar.gz.asc apache-ambari-3.0.0.tar.gz +## License -``` \ No newline at end of file +Apache Ambari is released under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). diff --git a/docusaurus.config.js b/docusaurus.config.js index ae2f5f30..44e4c21b 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -184,7 +184,10 @@ const config = { additionalLanguages: ['bash', 'diff', 'json'], }, }), - plugins: ['docusaurus-plugin-less',], + plugins: [ + 'docusaurus-plugin-less', + require.resolve('./src/plugins/csp-plugin'), + ], }; export default config; diff --git a/sidebars.js b/sidebars.js index 7a9c9b2b..230739d3 100644 --- a/sidebars.js +++ b/sidebars.js @@ -15,23 +15,23 @@ const sidebars = { // ambariSidebar: [{type: 'autogenerated', dirName: '.'}], - ambariSidebar: [ + "ambariSidebar": [ "introduction", "release-notes", "faq", { - type: "category", - label: "Quick Start", - collapsible: true, - collapsed: false, - items: [ + "type": "category", + "label": "Quick Start", + "collapsible": true, + "collapsed": false, + "items": [ "quick-start/quick-start-guide", { - type: "category", - label: "Environment Setup", - collapsible: true, - collapsed: false, - items: [ + "type": "category", + "label": "Environment Setup", + "collapsible": true, + "collapsed": false, + "items": [ "quick-start/environment-setup/vagrant-environment-setup", "quick-start/environment-setup/docker-environment-setup", "quick-start/environment-setup/bare-metal-kvm-setup" @@ -41,40 +41,51 @@ const sidebars = { ] }, { - type: "category", - label: "Ambari Design", - collapsible: true, - collapsed: false, - link: {type: 'doc', id: 'ambari-design/index'}, - items: [ + "type": "category", + "label": "Ambari Design", + "collapsible": true, + "collapsed": false, + "link": { + "type": "doc", + "id": "ambari-design/index" + }, + "items": [ "ambari-design/alerts", { - type: "category", - label: "Automated Kerberizaton", - link: {type: "doc", id: "ambari-design/kerberos/index"}, - items:[ + "type": "category", + "label": "Automated Kerberizaton", + "link": { + "type": "doc", + "id": "ambari-design/kerberos/index" + }, + "items": [ "ambari-design/kerberos/kerberos_descriptor", "ambari-design/kerberos/kerberos_service", "ambari-design/kerberos/enabling_kerberos" - ] + ] }, { - type: "category", - label: "Blueprints", - link: {type: "doc", id: "ambari-design/blueprints/index"}, - items: [ + "type": "category", + "label": "Blueprints", + "link": { + "type": "doc", + "id": "ambari-design/blueprints/index" + }, + "items": [ "ambari-design/blueprints/blueprint-ha", "ambari-design/blueprints/blueprint-ranger" ] }, "ambari-design/enhanced-configs/index", "ambari-design/service-dashboard/index", - { - type: "category", - label: "Metrics", - link: { type: "doc", id: "ambari-design/metrics/index" }, - items: [ + "type": "category", + "label": "Metrics", + "link": { + "type": "doc", + "id": "ambari-design/metrics/index" + }, + "items": [ "ambari-design/metrics/metrics-collector-api-specification", "ambari-design/metrics/configuration", "ambari-design/metrics/operations", @@ -86,14 +97,15 @@ const sidebars = { "ambari-design/metrics/ambari-metrics-whitelisting" ] }, - "ambari-design/quick-links", - { - type: "category", - label: "Stacks and Services", - link: {type: "doc", id: "ambari-design/stack-and-services/index"}, - items: [ + "type": "category", + "label": "Stacks and Services", + "link": { + "type": "doc", + "id": "ambari-design/stack-and-services/index" + }, + "items": [ "ambari-design/stack-and-services/overview", "ambari-design/stack-and-services/custom-services", "ambari-design/stack-and-services/defining-a-custom-stack-and-services", @@ -108,14 +120,15 @@ const sidebars = { "ambari-design/stack-and-services/version-functions-conf-select-and-stack-select" ] }, - "ambari-design/technology-stack", - { - type: "category", - label: "Views", - link: {type: "doc", id: "ambari-design/views/index"}, - items: [ + "type": "category", + "label": "Views", + "link": { + "type": "doc", + "id": "ambari-design/views/index" + }, + "items": [ "ambari-design/views/framework-services", "ambari-design/views/view-api", "ambari-design/views/view-definition" @@ -124,12 +137,15 @@ const sidebars = { ] }, { - type: "category", - label: "Ambari Development", - collapsible: true, - collapsed: false, - link: {type: 'doc', id: 'ambari-dev/index'}, - items: [ + "type": "category", + "label": "Ambari Development", + "collapsible": true, + "collapsed": false, + "link": { + "type": "doc", + "id": "ambari-dev/index" + }, + "items": [ "ambari-dev/building-from-source", "ambari-dev/running-tests", "ambari-dev/development-process-for-new-major-features", @@ -150,15 +166,21 @@ const sidebars = { ] }, { - type: "category", - label: "Ambari Plugin Contributions", - link: {type: 'doc', id: 'ambari-plugin-contribution/index'}, - items: [ + "type": "category", + "label": "Ambari Plugin Contributions", + "link": { + "type": "doc", + "id": "ambari-plugin-contribution/index" + }, + "items": [ { - type: "category", - label: "Ambari SCOM Management Pack", - link: {type: "doc", id: "ambari-plugin-contribution/scom/index"}, - items: [ + "type": "category", + "label": "Ambari SCOM Management Pack", + "link": { + "type": "doc", + "id": "ambari-plugin-contribution/scom/index" + }, + "items": [ "ambari-plugin-contribution/scom/installation" ] }, diff --git a/src/plugins/csp-plugin.js b/src/plugins/csp-plugin.js new file mode 100644 index 00000000..0550e102 --- /dev/null +++ b/src/plugins/csp-plugin.js @@ -0,0 +1,18 @@ +module.exports = function (context, options) { + return { + name: 'docusaurus-csp-plugin', + injectHtmlTags() { + return { + headTags: [ + { + tagName: 'meta', + attributes: { + 'http-equiv': 'Content-Security-Policy', + content: "default-src 'self'; img-src 'self' data: https://*.githubusercontent.com https://github.com; script-src 'self' 'unsafe-inline' 'unsafe-eval'; style-src 'self' 'unsafe-inline';" + }, + }, + ], + }; + }, + }; +}; \ No newline at end of file diff --git a/versioned_docs/version-3.0.0/introduction.md b/versioned_docs/version-3.0.0/introduction.md index 58a86116..79d86b28 100644 --- a/versioned_docs/version-3.0.0/introduction.md +++ b/versioned_docs/version-3.0.0/introduction.md @@ -29,17 +29,14 @@ Ambari enables Application Developers and System Integrators to: ## Getting Started with Ambari -Follow the [installation guide for Ambari 2.7.6](https://cwiki.apache.org/confluence/display/AMBARI/Installation+Guide+for+Ambari+2.7.6). +Follow the [quick start guide for Ambari 3.0.0](quick-start/quick-start-guide.md). Note: Ambari currently supports the 64-bit version of the following Operating Systems: -* RHEL (Redhat Enterprise Linux) 7.4, 7.3, 7.2 -* CentOS 7.4, 7.3, 7.2 -* OEL (Oracle Enterprise Linux) 7.4, 7.3, 7.2 -* Amazon Linux 2 -* SLES (SuSE Linux Enterprise Server) 12 SP3, 12 SP2 -* Ubuntu 14 and 16 -* Debian 9 +* Rocky Linux 8 +* Rocky Linux 9 +* OpenEuler 22 +* Other operating systems will be supported in future releases. ## Get Involved diff --git a/versioned_docs/version-3.0.0/release-notes.md b/versioned_docs/version-3.0.0/release-notes.md index f6e491a9..e43dae79 100644 --- a/versioned_docs/version-3.0.0/release-notes.md +++ b/versioned_docs/version-3.0.0/release-notes.md @@ -4,6 +4,10 @@ sidebar_position: 2 # Apache Ambari 3.0.0 Release Notes +## Download + +Apache Ambari 3.0.0 can be downloaded from the [Apache Ambari Download Page](https://apache-ambari.com/download/). + ## Overview :::tip Major Release @@ -291,9 +295,6 @@ For detailed instructions on upgrading from previous versions, please refer to t | Database | PostgreSQL 10+, MySQL 5.7+, MySQL 8+, MariaDB 10.2+, OceanBase | | Browser | Chrome 80+, Firefox 78+, Edge 80+ | -## Download - -Apache Ambari 3.0.0 can be downloaded from the [Apache Ambari Download Page](https://ambari.apache.org/download.html). ## Verification