跳到主要內容

Setup HTTP + PHP with docker

Introduction

過去我架設網站的方式不是用實體機器的OS,就是透過VirtualBox,不然就是VMWare ESXi。因為我對Docker不熟,所以這次趁著要報廢舊機器,開始嘗試使用Docker架站。本篇記錄我在Rocky Linux 9.2上的設定過程。

Steps

Install Docker and Docker-Compose

在Rocky Linux 9已轉變為使用podman去管理容器,所以當我執行下方指令時,實際上會更新podman與安裝podman-docker。
sudo dnf install docker
如果直接使用docker-compose去安裝,會找不到對應的package。參考網路作法是要自己下載額外處理,所以我直接使用Rocky Linux的解法:
sudo dnf install podman-compose

Prepare files

在撰寫dockerfile或docker-compose過程,跌跌撞撞。在這奉勸一句,對於不熟悉的項目,尤其和軟體或系統設定有關,“千萬”別照抄Chatgpt,否則你解問題的經驗值會暴增。我最後是基於這篇文章內容,去修改並解決相關環境問題。此作者結構設計非常清楚,app資料夾負責放對應的web應用程式,以我來說就是dokuwiki;php資料夾放置獨立php-fpm container的dockerfile,方便調整環境設定;最後就是docker-compose與nginx的設定檔。
├── app
│   ├── index.php
│   └── dokuwiki
├── docker-compose.yaml
├── nginx.conf
└── php
    ├── Dockerfile
    └── php.ini

docker-compose.yaml

這裡須注意的是depends_on去控制啟動順序,而links讓nginx可以存取php,因為naginx會把php的request forward到9000的port。這裡須注意的是depends_on去控制啟動順序,而links讓nginx可以存取php,因為naginx會把php的request forward到9000的port。
version: '1'
services:
  nginx:
    image: library/nginx:1.19-alpine
    container_name: "http_nginx"
    ports:
      - 80:80
    volumes:
      - "./nginx.conf:/etc/nginx/conf.d/default.conf"
      - "./app:/var/www/html"
    depends_on:
      - php
    links:
      - php
  php:
    image: "dokuwiki"
    build: ./php
    container_name: "dokuwiki"
    ports:
      - 9000:9000
    volumes:
      - "./app:/var/www/html"

nginx.conf

大部分內容都是參考別人的,唯一有特別調整的只有fastcgi_pass php:9000。原始範例是使用localhost:9000,但可能因為我使用podman的關係,所以要把localhost改為service name php才有辦法正確的redirect request。
server {
    listen       80;
    server_name  localhost;
    root   /var/www/html;
    index  index.php;
 
    location ~ \.php(/|$) {
        fastcgi_pass php:9000;
        fastcgi_split_path_info       ^(.+\.php)(.*)$;
        fastcgi_param SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO        $fastcgi_path_info;
        fastcgi_buffer_size 128k;
        fastcgi_buffers 4 256k;
        fastcgi_busy_buffers_size 256k;
        include        fastcgi_params;
    }
 
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /var/www/html;
    }
}

Dockerfile

因為我不需要什麼超強的php工具集,所以我只留以下內容。
FROM php:7.4.9-fpm-alpine

COPY php.ini $PHP_INI_DIR/conf.d/

php.ini與index.php

參考別人的,沒什麼特別。
php.ini:
date.timezone = "Asia/Taipei"
display_errors = 1
error_reporting = E_ALL
index.php:

<?php
phpinfo();

First Startup

接著在docker-compose設定檔的目錄下,執行以下指令:
podman-compose up
在連至我的dokuwiki後,就出現以下錯誤:

Tune Permission

因為我不需要什麼超強的php工具集,所以我只留以下內容。研究後,發現root cause是由於php container對於dokuwiki的volume沒有寫入的權限。要解決這個問題,就是讓container與外部系統對應資料有相同的使用者即可;而container對於外部系統的使用者,只會認得ID。這意味著就是讓彼此的ID相同就可以解決這個問題。

設定外部系統資料夾擁有者

首先查詢要設定的使用者ID:
[root@localhost dokuwiki]# id -u tonylin
1000
將使用者與群組設定到對應目錄上:
chown -R tonylin:tonylin app

調整PHP Dockerfile權限

重新建立www-data使用者與群組,並將ID設為1000。設為1000的原因,是由於前一步驟已經查到使用者ID為1000。
FROM php:7.4.9-fpm-alpine

RUN apk --no-cache add shadow

COPY php.ini $PHP_INI_DIR/conf.d/

ARG USER_ID=1000
ARG GROUP_ID=1000

RUN userdel -f www-data &&\
    if getent group www-data ; then groupdel www-data; fi &&\
    groupadd -g ${GROUP_ID} www-data &&\
    useradd -l -u ${USER_ID} -g www-data www-data &&\
    install -d -m 0755 -o www-data -g www-data /home/www-data
如果上述腳本執行有問題,可以執行底下指令去看build container的詳細執行過程。
podman-compose up -build

Startup again

最後在docker-compose設定檔的目錄下,執行以下指令,然後就可以看到畫面了~
podman-compose up

接下來我就要開始設定憑證和讓網站上線了。

Reference

留言

這個網誌中的熱門文章

PostgreSQL - Unattended installation on windows

Introduction 要將別人軟體包裝到自己軟體中,不可或缺的東西就是Unattended installation。以Unattended installation來說,我們可以選擇透過Installer的silent mode安裝,也可以透過把目標軟體做成portable的版本。本篇文章分享這兩種方法,教導大家如何將PostgreSQL透過Unattended installation方式安裝到目標系統成為service。 Note. 本篇以PostgreSQL 10.7為例。 Install with installer Tips 安裝程式或反安裝程式的參數,除了可以直接上官網搜尋Installation User Guide以外,也可以直接使用help參數查詢: postgresql- 10.7 - 2 -windows-x64.exe --help Windows安裝程式主要有EnterpriseDB與BigSQL兩種。BigSQL版本安裝元件是透過網路下載且支援參數不如EnterpriseDB版本多,以我們需求來說,我們傾向於使用EnterpriseDB版本。接下來分享給大家安裝與反安裝方法。 Installation @ echo off set INSTALL_DIR =C:\postgres10 set INSTALLER =postgresql- 10.7 - 2 -windows-x64.exe   rem options for installation set SSMDB_SERVICE =postgresql- 10 set MODE =--unattendedmodeui none --mode unattended   set DB_PASSWD =--superpassword postgres set DB_PORT =--serverport 5432   set SERVICE_NAME =--servicename % SSMDB_SERVICE %   set PREFIX =--prefix "%INSTALL_DIR%" set DATA_DIR =--datadir "%INSTALL_DIR%\data"   set OPTIONS =

How to install RIDE on Windows?

Introduction 多年沒在Windows上開發RobotFramework,趁著這次整理一下RIDE安裝方法。 目前RIDE最新版本與Python對應版本如下: (3.6 < python <= 3.11) Install current released version (2.0.8.1) with: pip install -U robotframework-ride 安裝Python 直接到Python官網找尋最新的3.11版本,我使用3.11.9: link 。安裝就是一直下一步而已。 安裝wxPython 每次安裝RIDE最困難的都是wxPython。看了一下 官網 描述,我就姑且相信一下: 接著進入下 載頁面 就有安裝教學。基本上就是到Python目錄下的Scripts直接執行以下command: pip install -U wxPython 安裝RIDE 接著就如RIDE官網所說,執行以下command: pip install -U robotframework-ride 啟動RIDE 直接在相同目錄下執行ride就可以啟動了,你也可以直接在桌面建ride連結,加快下次啟動時間。 沒想到這次這麼順利就安裝完成了。因為我是使用java去啟動robot framework,就不特別講要怎麼使用pip安裝robot framework了。

Hello World!

即將要搬家,因此舊網頁內容將慢慢轉移至Blogger。 如果要存取舊網頁,可以使用以下連結: https://wiki.tonylin.idv.tw/dokuwiki/doku.php