Versions Compared

Old Version 4

changes.mady.by.user Michael Miklavcic

Saved on

compared with

New Version 5

changes.mady.by.user Justin Leet

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Ensure that the website comes up on http://localhost:4000 and exit whenever that is done
  • Save off a zipped copy of metron/site/target (you don't want a parent directory in the zip itself since we unzip it right into the site branch directory)
    • cd metron/site/target
    • zip -r /tmp/metron-site.zip .
  • Checkout the asf-site branch
    • Ensure at git status says you have no untracked files.  Sometimes a checkout will bring along some rogue files that are untracked in master such as target directories. You can run the following command to clean up.
    • git clean -fd
    • If you see your branch is behind, do a `git pull` before updating the site branch with local changes.
  • Unzip the copy of the target into metron
    • unzip /tmp/metron-site.zip .
  • Ensure that the change looks right by running python -m SimpleHTTPServer and navigating to http://localhost:8000
  • Commit locally with a commit message that references the JIRA. e.g. METRON-177: Sync'ing asf-site from the generated code on master.
  • Push to apache via git push apache asf-site (assuming you named the apache remote repo 'apache')

Validate the Live Site

After pushing the asf-site branch, go to the live site and reload (this may take a few seconds to go live). Click around and ensure the live site looks as expected.

Troubleshooting

If you have trouble installing Jekyll you may need to add some additional tools to get it to compile. This worked for me on Mac OSX 10.13.1 (High Sierra), Homebrew 1.5.3, Ruby 2.5.0p0. (Skip the ruby install if you already have it configured properly.)

...