Skip to content

Commit

Permalink
Add Dockerfile for easy installation on local machine (#532)
Browse files Browse the repository at this point in the history
  • Loading branch information
pourmand1376 authored Jul 10, 2022
1 parent c09d3ee commit 0e9d3a4
Show file tree
Hide file tree
Showing 6 changed files with 106 additions and 1 deletion.
32 changes: 32 additions & 0 deletions .github/workflows/deploy-image.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
name: Docker Image CI

on:
push:
branches: [ master ]
pull_request:
branches: [ master ]

jobs:

build:

runs-on: ubuntu-latest

steps:
- name: Checkout
uses: actions/checkout@v2
- name: Buildx
uses: docker/setup-buildx-action@v1

- name: Login
uses: docker/login-action@v1
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}

- name: Build and push
uses: docker/build-push-action@v2
with:
context: .
push: true
tags: amirpourmand/al-folio
13 changes: 13 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
FROM jekyll/jekyll
Label MAINTAINER Amir Pourmand
#install imagemagick tool for convert command
RUN apk add --no-cache --virtual .build-deps \
libxml2-dev \
shadow \
autoconf \
g++ \
make \
&& apk add --no-cache imagemagick-dev imagemagick
WORKDIR /srv/jekyll
ADD Gemfile /srv/jekyll/
RUN bundle install
43 changes: 42 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,48 @@ Why Jekyll? Read [Andrej Karpathy's blog post](https://karpathy.github.io/2014/0

### Installation

#### Local setup
#### Local setup using Docker (Recommended on Windows)

You need to do these step to get `al-folio` up and running in your local machine:

- Install [docker](https://docs.docker.com/get-docker/)
- Clone your repository

```bash
git clone git@github.com:<your-username>/<your-repo-name>.git
cd <your-repo-name>
```

Then you can use Dockerhub prebuilt image to run your website. Note that for the first time it would download an image of size 300MB or so.

```bash
bin/dockerhub_run.sh
```

> Currently, you should opt this method, only if you are using newest version of al-folio. If you are using an old version. You should build your own image.
<details><summary>(click to expand) <strong>Build your own docker image (more advanced):</strong></summary>

First, download the necessary modules and install them into a docker image called `al-folio:Dockerfile` (this command will build an image which is used to run your website afterwards. Note that you only need to do this step once. After you have the image, you no longer need to do this anymore):


\```bash
bin/docker_build_image.sh
\```

Run the website!

\```bash
bin/docker_run.sh
\```

> To change port number, you can edit `docker_run.sh` file.
> If you want to update jekyll, install new ruby packages, etc., all you have to do is build the image again using `docker_build_image.sh`! It will download ruby and jekyll and install all ruby packages again from scratch.
</details>

#### Local Setup (Standard)

Assuming you have [Ruby](https://www.ruby-lang.org/en/downloads/) and [Bundler](https://bundler.io/) installed on your system (*hint: for ease of managing ruby gems, consider using [rbenv](https://github.com/rbenv/rbenv)*), first [fork](https://guides.github.com/activities/forking/) the theme from `github.com:alshedivat/al-folio` to `github.com:<your-username>/<your-repo-name>` and do the following:

Expand Down
5 changes: 5 additions & 0 deletions bin/docker_build_image.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
FILE=Gemfile.lock
if [ -f "$FILE" ]; then
rm $FILE
fi
docker build -t "al-folio:latest" .
7 changes: 7 additions & 0 deletions bin/docker_run.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
FILE=Gemfile.lock
if [ -f "$FILE" ]; then
rm $FILE
fi
docker run --rm -v "$PWD:/srv/jekyll/" -p "8080:8080" \
-it al-folio:latest bundler \
exec jekyll serve --watch --port=8080 --host=0.0.0.0
7 changes: 7 additions & 0 deletions bin/dockerhub_run.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
FILE=Gemfile.lock
if [ -f "$FILE" ]; then
rm $FILE
fi
docker run --rm -v "$PWD:/srv/jekyll/" -p "8080:8080" \
-it amirpourmand/al-folio bundler \
exec jekyll serve --watch --port=8080 --host=0.0.0.0

0 comments on commit 0e9d3a4

Please sign in to comment.