This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/accumulo-website.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new cec1eb0a Automatic Site Publish by Buildbot
cec1eb0a is described below
commit cec1eb0a84a0ef0f372ca63302945c3f1d15f5ac
Author: buildbot <[email protected]>
AuthorDate: Wed Apr 26 16:57:21 2023 +0000
Automatic Site Publish by Buildbot
---
output/Dockerfile | 34 ++++++++++++++++++++++++++++++++++
output/README.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
output/feed.xml | 4 ++--
3 files changed, 80 insertions(+), 2 deletions(-)
diff --git a/output/Dockerfile b/output/Dockerfile
new file mode 100644
index 00000000..249f779c
--- /dev/null
+++ b/output/Dockerfile
@@ -0,0 +1,34 @@
+# This Dockerfile builds an ruby environment for jekyll that empowers
+# making updates to the accumulo website without requiring the dev
+# to maintain a local ruby development environment.
+
+FROM ruby:2.7.8-slim-bullseye as base
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+ build-essential \
+ git \
+ curl \
+ && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /mnt/workdir
+
+# Copy over the Gemfiles so that all build dependencies are installed
+# during the docker build. At runtime, these will be available to Jekyll
+# from the mounted directory. But that's not available during the
+# docker build, so we need to copy them in to pre-install the Gems
+
+COPY Gemfile ./Gemfile
+COPY Gemfile.lock ./Gemfile.lock
+
+# Gems will be installed under GEM_HOME which is set by the ruby image.
+# See https://hub.docker.com/_/ruby for details.
+
+RUN gem update --system && bundle install && gem cleanup
+
+ENV HOST=0.0.0.0
+ENV PORT=4000
+
+EXPOSE $PORT
+
+# Configure the default command to build from the mounted repository.
+CMD bundle exec jekyll serve --force-polling -H $HOST -P $PORT
diff --git a/output/README.md b/output/README.md
index b064a77a..65e2cf45 100644
--- a/output/README.md
+++ b/output/README.md
@@ -108,6 +108,50 @@ HTML styled "just right".
Jekyll will print a local URL where the site can be viewed (usually,
[http://0.0.0.0:4000/](http://0.0.0.0:4000/)).
+### Testing using Docker environment
+
+A containerized development environment can be built using the local
+Dockerfile.
+
+
+A containerized development environment can be built using the local
+Dockerfile. You can build it with the following command:
+
+```bash
+docker build -t webdev .
+```
+
+This action will produce a `webdev` image, with all the website's build
+prerequisites preinstalled. When a container is run from this image, it
+will perform a `jekyll serve` command with the polling option enabled,
+so that changes you make locally will be immediately reflected.
+
+When you run a container using the webdev image, your current working
+directory will be mounted, so that any changes made by the build inside
+the container will be reflected in your local workspace. This is done with
+the `-v` flag. To run the container, execute the following command:
+
+```bash
+docker run -d -v "$PWD":/mnt/workdir -p 4000:4000 webdev
+```
+
+While this container is running, you will be able to review the rendered
website
+in your local browser at [http://127.0.0.1:4000/](http://127.0.0.1:4000/).
+
+
+Shell access can be obtained by overriding the default container command.
+
+This is useful for adding new gems, or modifying the Gemfile.lock for updating
+existing dependencies.
+
+When using shell access the local directory must be mounted to ensure
+the Gemfile and Gemfile.lock updates are reflected in your local
+environment so you can create a commit and submit a PR.
+
+```bash
+docker run -v "$PWD":/mnt/workdir -it webdev /bin/bash
+```
+
## Publishing
### Automatic Staging
diff --git a/output/feed.xml b/output/feed.xml
index f39c0391..284af567 100644
--- a/output/feed.xml
+++ b/output/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>https://accumulo.apache.org/</link>
<atom:link href="https://accumulo.apache.org/feed.xml"; rel="self"
type="application/rss+xml"/>
- <pubDate>Mon, 17 Apr 2023 16:30:18 +0000</pubDate>
- <lastBuildDate>Mon, 17 Apr 2023 16:30:18 +0000</lastBuildDate>
+ <pubDate>Wed, 26 Apr 2023 16:57:14 +0000</pubDate>
+ <lastBuildDate>Wed, 26 Apr 2023 16:57:14 +0000</lastBuildDate>
<generator>Jekyll v4.3.1</generator>
