chore(docker): serve interactively in a container

Author: slack

Dockerfile

@@ -6,4 +6,4 @@ WORKDIR /app
 RUN pip install -r requirements.txt
 
 EXPOSE 8000
-CMD ["mkdocs", "serve", "-a", "0.0.0.0:8000"]
+ENTRYPOINT ["mkdocs", "serve", "-a", "0.0.0.0:8000"]

Makefile

@@ -6,12 +6,27 @@ BUILDDIR        = _build
 MKDOCS          = mkdocs
 MKDOCSBUILDOPTS = --clean --strict --verbose
 MKDOCSBUILD     = $(MKDOCS) build $(MKDOCSBUILDOPTS)
+MKDOCSSERVE     = $(MKDOCS) serve -a 0.0.0.0:8000
+
+SHORT_NAME ?= docs-v2
+VERSION ?= git-$(shell git rev-parse --short HEAD)
+IMAGE := ${SHORT_NAME}:${VERSION}
+
+REPO_PATH := github.com/deis/${SHORT_NAME}
+DEV_ENV_WORK_DIR := /src/${REPO_PATH}
+DEV_ENV_PREFIX := docker run --rm -v ${CURDIR}:${DEV_ENV_WORK_DIR} -w ${DEV_ENV_WORK_DIR} -p 8000:8000
+DEV_ENV_CMD := ${DEV_ENV_PREFIX} ${DEV_ENV_IMAGE}
 
 build:
 	$(MKDOCSBUILD) --site-dir $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 
+serve:
+	$(MKDOCSSERVE)
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
 clean:
 	rm -rf $(BUILDDIR)/*
 
@@ -22,3 +37,9 @@ test: build
 	grep -q '<h1 id="welcome">Welcome</h1>' _build/html/index.html
 	@echo
 	@echo "Test finished. The HTML pages are in $(BUILDDIR)/html."
+
+docker-build:
+	docker build --rm -t ${IMAGE} .
+
+docker-serve:
+	${DEV_ENV_CMD} ${IMAGE}