deployment/README: Dockerise

Author: plowsof

Dockerfile

@@ -0,0 +1,17 @@
+FROM ruby:3.0.1@sha256:d1a8c5160d98cdd51000d3ebfc75ccdad5f43c4b319bbd9e0212dfc337c1e4b5
+
+WORKDIR /srv/jekyll
+
+COPY Gemfile Gemfile.lock ./
+
+RUN gem install bundler:2.2.23
+
+RUN bundle install --jobs 4 --retry 3
+
+RUN chown 1000:1000 -R /srv/jekyll
+
+# Expose Jekyll's default port
+EXPOSE 4000
+
+# Default is to serve the site @ localhost:4000
+CMD ["bundle", "exec", "jekyll", "serve", "--host", "0.0.0.0"]

README.md

@@ -9,21 +9,27 @@ If you need support about something related to the website, please join `#monero
 
 ## What you'll need
 
-* Jekyll: [getmonero.org](https://getmonero.org/) is made using a simple, static website generator called [Jekyll](https://jekyllrb.com/). You will need it installed on your system to test any changes that you made. Follow the instructions on the website to get up and going:
-  * Install Ruby dependencies as suggested [in the Jekyll documentation](https://jekyllrb.com/docs/installation/)
-  * Install Bundler: `gem install bundler`
-  * Install Jekyll with all dependencies (run from the project directory): `bundle`
+* Docker: to ease development, we are moving to local deployments requiring Docker. Setup instructions for your operating system can be found on the official [Docker website](https://docs.docker.com/desktop/).
 
 * GitHub/GitLab: Pretty much everything in Monero is hosted on [GitHub](https://github.com/monero-project) or [getmonero GitLab](https://repo.getmonero.org/users/monero-project/projects) and uses Git as the primary version control system. If you're not familiar with how to use Git, you can check out [this tutorial](https://guides.github.com/activities/hello-world/) for a good overview. It will take you through pretty much everything you'll need to know to edit the website. If you haven't already, register on GitHub and fork the [Monero Website repository](https://github.com/monero-project/monero-site).
 
-*Note: If you're confused, feel free to click other files in the same directory (folder) that you are in for the step that you are on to see some working examples. Compare them to the instructions and you should understand better.*
+1. Navigate to your local `monero-site` git repository.
+2. build the Docker container with `docker build --no-cache -t getmonero-container .`
+3. Then serve with: `docker run -p 4000:4000 -v $(pwd):/srv/jekyll getmonero-container`. If you want, you can speedup this process by loading only the last blog post instead of all of them. Add `bundle exec jekyll serve --limit_posts 1 --host 0.0.0.0` to the command above.
+4. Open a browser and go to [http://127.0.0.1:4000](http://127.0.0.1:4000).
+5. If all went well, you should see the Monero website and you're ready to make changes.
 
-Once you have the above list of things, it's encouraged to build the website from your local computer to make sure it works before you make any changes. To do this, complete the following steps:
+To build without serving:
 
-1. Navigate to your local `monero-site` repository.
-2. Serve the website: `bundle exec jekyll serve`. If you want, you can speedup this process by loading only the last blog post instead of all of them. Simply add `--limit_posts 1` to the command above. The resulting command will be `bundle exec jekyll serve --limit_posts 1`.
-3. Open a browser and go to [http://127.0.0.1:4000](http://127.0.0.1:4000).
-4. If all went well, you should see the Monero website and you're ready to make changes.
+1. Rebuild the Docker container with `docker build --no-cache -t getmonero-container .` (only required if Gemfile* has been modified)
+2. `docker run -v $(pwd):/srv/jekyll getmonero-container bundle exec jekyll build` (Output dir can be changed by adding `--destination <output dir>`)
+3. If successful, `_site` will contain the generated HTML files.
+
+To update the gems:
+
+1. `docker run -v $(pwd):/srv/jekyll getmonero-container bundle update`
+2. Confirm compatibility by rebuilding the container with the new gems using `docker build --no-cache -t getmonero-container .`
+3. If updates are found, the resulting `Gemfile.lock` can be pushed to this repo. 
 
 ## General change recommendations