Merge pull request #211 from apache/staging-site

Merge main
tree: 79f20ce30e99a283a9703dd9464e89cb3af12a75
  1. .github/
  2. blog/
  3. docs/
  4. source/
  5. src/
  6. static/
  7. .asf.yaml
  8. .gitignore
  9. babel.config.js
  10. CONTRIBUTING.md
  11. docusaurus.config.js
  12. LICENSE
  13. package.json
  14. README.md
  15. tsconfig.json
  16. yarn.lock
README.md

Apache CloudStack Official Website

This project keeps all sources used for building up the Apache CloudStack official website which is served at https://cloudstack.apache.org/.

Contributing

For contributing changes such as adding/editing blogs, please see the:

CONTRIBUTING.md

Prerequisite

Apache CloudStack website is powered by Docusaurus 2. Please install Node.js v16 or later and yarn.

Local Development

Install dependencies:

$ yarn install

Start local app server on localhost:3000:

$ yarn start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Building and Publishing

It can be useful at times to start anew:

$ yarn clear

To build the website run the following:

$ yarn build

This command generates static content into the build directory and can be served using any static contents hosting service. We've GitHub Actions based automation that can publish changes merged to ‘main’ branch being automatically published to the ‘asf-site’. see the procedure below.

publishing procedure

  • create a change
  • test your change according to the previous chapter
  • create a PR against staging
  • merge
  • wait for the staged-site to be updated and published
  • check the staging site
  • next, on your local machine
    • pull the latest staging-site and main branches
    • merge staging-site to main
    • push main
git checkout staging-site
git pull
# git clean -d or similar if needed
git checkout main
git pull
git merge --ff-only staging-site
git push
  • wait for asf-site to be updated and published to the main site
  • check again
  • go to sleep