User:Vladimir Panteleev/Website staging

From D Wiki
Jump to: navigation, search

The dlang.org staging area provides a controlled environment for building the latest version of dlang.org from GitHub, previewing the website, and uploading it to the live website.

Rationale

  • Removes requirement to install software to fully build dlang.org (e.g. kindlegen)
  • Removes requirement to use a Posix OS (completely building the website is currently impossible on Windows)
  • Removes issues due to environment (wrong/incompatible software versions, e.g. rsync)
  • Removes bottlenecks on Jan (dlang.org system administrator) to add users or resolve permission issues
  • Removes upload bandwidth bottleneck for slow connections
  • Fixes users having to upload the entire site because timestamps don't match between users' local copies

Usage

  1. If there have been some significant changes in the build infrastructure which might cause a dirty build, run:
    ssh dlang@k3.1azy.net run/clean
    This will delete all intermediary files and force clean all repositories (incl. dub stuff).
  2. Run ssh dlang@k3.1azy.net run/update
  3. Browse to http://dlang.k3.1azy.net/ and make sure there are no glaring problems.
  4. Run ssh dlang@k3.1azy.net run/upload

If you already have access to dlang.org, send your public SSH key to User:Vladimir Panteleev to get access.

Retrieved from "https://wiki.dlang.org/?title=User:Vladimir_Panteleev/Website_staging&oldid=6051"