OVH Docs : Developer environment

Easy to deploy developer environment, for writing/testing guides & documentations for docs.ovh.com

With Docker

Prerequisite

• Docker installed

with build.sh

Show help

./build.sh -h

> build.sh [-h] [-f folder] [-p port] build and start docs.ovh.com in a docker container
>
> where:
>    -h  show this help
>    -f  set the docs repo path to build (default: current directory)
>    -p  set the exposed docker port (default: 8080)

Start the build

./build.sh -f /path/to/docs/repository

Next, go to http:///localhost:8080/fr/

without build.sh

Step 1, build the docker image

git clone https://github.com/ovh/docs-developer-env.git
cd docs-developer-env
docker build -t ovh-docs-dev-env .

Step 2, run docker container

# get the ovh docs repository
git clone https://github.com/ovh/docs.git
cd docs
# run the container and mount volume "pages" (change the port to suit your needs, here XXXXX)
# the port 8080 is the exposed one, so don't change it
docker run --rm -v $(pwd)/pages:/src/docs/pages -d --name ovh-docs-dev-env -p XXXXX:8080 ovh-docs-dev-env

Note 1 : $(pwd)/pages above is the path to the pages folder of your local docs repository Note 2 : the pelican build, started in debug mode, takes 1 or 2 minutes to complete.

Step 3, check the logs

docker logs -f ovh-docs-dev-env

When the build is complete, go to http://localhost:XXXXX/fr/ and check your works.

Finally, stop the container

docker stop ovh-docs-dev-env