How to deploy a wordpress site?

[kishaningithub]

It would be great to have an example which explains how to deploy a wordpress site just like the below one which explains the same using docker compose.

https://github.com/docker/awesome-compose/tree/master/official-documentation-samples/wordpress/

Thanks in advance! 😊

[kishaningithub]

I feel the Kamal documentation should contain a cookbook section which in addition to the example requested above should contain tips, caveats and best practices when using kamal

[kishaningithub]

I tried doing this but ended up with the following error

ERROR (Kamal::Commands::Builder::Base::BuilderError): Missing Dockerfile

and there seems to be no option (unless i am missing something) to disable this builder thing because in my case i only want to pull wordpress image and not build and push something.

[aka47]

This is a very board question, usally you create a project with a Dockerfile. Here is the one I am using. You should have a look at the Wordpress Docker documentation, it is worth reading.

I use hetzner with a volume mounted under /mnt/volume-wordpress-data where all uploads and static files are stored.

FROM wordpress:latest

### Dependency Installation
RUN apt update && \
    apt upgrade -y && \
    apt install -y python3 vim less && \
### WP-CLI Installation
    curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar && \
    chmod +x wp-cli.phar && \
    mv wp-cli.phar /usr/bin/wp-cli && \
    chmod 755 /usr/bin/wp-cli && \
    a2enmod headers && 
    
### Cleanup
    rm -rf /var/cache/apt/*

# Copying Themes and Plugins into the wordpress image
COPY ["themes","/usr/src/wordpress/wp-content/themes"]
COPY ["plugins","/usr/src/wordpress/wp-content/plugins"]

# Applying the execution right on the folders for apache
COPY entrypoint-child.sh /usr/bin/
RUN chmod +x /usr/bin/entrypoint-child.sh

# Updating the configuration of wordpress image with our own
COPY ./config/uploads.ini /usr/local/etc/php/conf.d/uploads.ini
COPY ./config/docker-apache.conf /etc/apache2/conf-enabled/docker-apache.conf

EXPOSE 8080

ENTRYPOINT ["entrypoint-child.sh"]
CMD ["apache2-foreground"]

my deploy.yaml looks like this, I have a wp multisite so it is a bit more complex. Some parts have I move into a traefik.yaml file

# Name of your application. Used to uniquely configure containers.
service: wordpresses

# Name of the container image.
image: githubusername/wordpresses

# Deploy to these servers.
servers:
  web:
    hosts:
      - xxx.xxx.xxx.xxx
    labels:
      traefik.http.routers.wp.rule: "Host(`xxxx.com`) || Host(`xxx.de`)"
      traefik.http.routers.wp_secure.entrypoints: websecure
      traefik.http.routers.wp_secure.rule: "Host(`xxxx.com`) || Host(`xxxx.de`)"
      traefik.http.routers.wp_secure.tls: true
      traefik.http.routers.wp_secure.tls.certresolver: letsencrypt

volumes:
  - "/mnt/volume-wordpress-data/wordpress-data:/var/www/html"

  - config/apache/:/tmp/apache3/
# Credentials for your image host.
registry:
  # Specify the registry server, if you're not using Docker Hub
  server: ghcr.io
  username: xxxx

  # Always use an access token rather than real password when possible.
  password:
    - GITHUB_REGISTRY_PASSWORD

# Inject ENV variables into containers (secrets come from .env).
# Remember to run `kamal env push` after making changes!
env:
  clear:
    WORDPRESS_DB_HOST: xxx.xxx.xxx.xxx
    WORDPRESS_DB_NAME: wordpresses

  secret:
    - WORDPRESS_DB_USER
    - WORDPRESS_DB_PASSWORD
    - WORDPRESS_DB_NAME

accessories:
  db:
    image: mariadb:lts
    host: xxx.xxx.xxx.xxx
    port: 3306
    env:
      clear:
        MYSQL_ROOT_HOST: '%'
      secret:
        - MARIADB_ROOT_PASSWORD
    files:
      - db/wordpress-backup-290224.sql:/docker-entrypoint-initdb.d/setup.sql
    volumes:
      - "/mnt/volume-wordpress-data/mysql-data:/var/lib/mysql"

traefik:
  options:
    publish:
      - "443:443"
  files:
    - config/traefik.yaml:/etc/traefik/traefik.yaml
  directories:
    - config/apache/:/tmp/apache/
  volumes:
    - "/config/apache:/tmp/apache2/"
    - "/mnt/volume-wordpress-data/letsencrypt/acme.json:/letsencrypt/acme.json"
  

# Configure a custom healthcheck (default is /up on port 3000)
healthcheck:
  path: /
  port: 8080

[kishaningithub]

Thanks a lot for such a detailed explanation!

[DeandrePetersen]

Managing your setup using Docker Compose is a cool and recommended option. In fact, over the internet, there are good tutorials about how to do that step by step, exactly like the one you mentioned. This might be in the form of examples of what you are interested in looking at by looking at some existing Wordpress blog examples. You can get an idea of how these themes and plugins are used. You will also probably be inspired for your site. Besides, allowing the entry of the real-world examples will make the learning more engaging and applicable. With a bit of practice and the right resources, you'll have your site up and running smoothly in no time.