Adicionar suporte a multi-arquitetura no Docker com QEMU e Buildx, atualizar workflows do GitHub Actions e melhorar a documentação

Author: marcelofmatos

.github/workflows/docker-image.yml

@@ -24,25 +24,43 @@ jobs:
         submodules: recursive  # Equivalente ao GIT_SUBMODULE_STRATEGY
         token: ${{ secrets.GITHUB_TOKEN }}
 
+    - name: Set up QEMU
+      uses: docker/setup-qemu-action@v3
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
     - name: Log in to GitHub Container Registry
-      run: echo "${{ secrets.GITHUB_TOKEN }}" | docker login ghcr.io -u ${{ github.actor }} --password-stdin
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
 
     - name: Convert repository and tag name to lowercase
       id: lowercase_names
       run: |
         echo "repository_name=$(echo ${{ github.repository }} | tr '[:upper:]' '[:lower:]')" >> $GITHUB_ENV
         echo "tag_name=$(echo ${{ github.ref_name }} | tr '[:upper:]' '[:lower:]')" >> $GITHUB_ENV
 
-    - name: Build Docker image
-      run: docker build --build-arg APP_VERSION=${{ env.tag_name }} --build-arg GIT_COMMIT=$(git rev-parse --short HEAD) -t ghcr.io/${{ env.repository_name }}:${{ env.tag_name }} .
-
-    - name: Push Docker image
+    - name: Compose image tags
+      id: tags
       run: |
-        docker push ghcr.io/${{ env.repository_name }}:${{ env.tag_name }}
+        TAGS="ghcr.io/${{ env.repository_name }}:${{ env.tag_name }}"
         if [ "${{ github.event_name }}" = "release" ]; then
-          docker tag ghcr.io/${{ env.repository_name }}:${{ env.tag_name }} ghcr.io/${{ env.repository_name }}:latest
-          docker push ghcr.io/${{ env.repository_name }}:latest
+          TAGS="$TAGS,ghcr.io/${{ env.repository_name }}:latest"
         fi
+        echo "tags=$TAGS" >> $GITHUB_OUTPUT
+
+    - name: Build and push Docker image (multi-arch)
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        platforms: linux/amd64,linux/arm64
+        push: true
+        tags: ${{ steps.tags.outputs.tags }}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max
 
   update-services:
     runs-on: ubuntu-latest

.github/workflows/release-and-build.yml

@@ -169,10 +169,10 @@ jobs:
 
           **Run the container:**
           \`\`\`bash
-          docker run -d -p 8080:3000 --env-file .env ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:$NEW_VERSION
+          docker run -d -p 80:80 ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:$NEW_VERSION
           \`\`\`
 
-          **Platforms**: linux/amd64
+          **Platforms**: linux/amd64, linux/arm64
 
           ### 📋 Release Info
           - **Type**: $VERSION_TYPE release
@@ -200,10 +200,13 @@ jobs:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: 🧰 Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
       - name: 🏗️ Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
-          platforms: linux/amd64
+          platforms: linux/amd64,linux/arm64
 
       - name: 🔐 Login to Container Registry
         uses: docker/login-action@v3
@@ -236,9 +239,9 @@ jobs:
             type=raw,value=${{ steps.semantic_tags.outputs.major_version }}
             type=raw,value=latest,enable={{is_default_branch}}
           labels: |
-            org.opencontainers.image.title=Fishboard
-            org.opencontainers.image.description=Modern project management dashboard
-            org.opencontainers.image.vendor=Abstrakt Agencia
+            org.opencontainers.image.title=PHPNetMap
+            org.opencontainers.image.description=Network device monitoring with SNMP
+            org.opencontainers.image.vendor=Marcelo Matos
             org.opencontainers.image.licenses=MIT
 
       - name: 🔍 Build and test Docker image
@@ -254,7 +257,7 @@ jobs:
         uses: docker/build-push-action@v5
         with:
           context: .
-          platforms: linux/amd64
+          platforms: linux/amd64,linux/arm64
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
@@ -269,7 +272,7 @@ jobs:
           echo "## ✅ Release $NEW_VERSION Created and Published!" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "**🏷️ Version**: $NEW_VERSION" >> $GITHUB_STEP_SUMMARY
-          echo "**🌍 Platforms**: linux/amd64" >> $GITHUB_STEP_SUMMARY
+          echo "**🌍 Platforms**: linux/amd64, linux/arm64" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "### 🐳 Docker Tags Available" >> $GITHUB_STEP_SUMMARY
           echo "- \`${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:$NEW_VERSION\` (full version)" >> $GITHUB_STEP_SUMMARY

Dockerfile

@@ -1,28 +1,56 @@
-# A basic config. for phpnetmap
+# PHPNetMap — imagem self-contained equivalente ao tutum/php-apache.
+# Base oficial multi-arch (linux/amd64 + linux/arm64) com Apache + mod_php.
+FROM php:7.4-apache
 
-FROM tutum/apache-php
-
-MAINTAINER Marcelo Matos <marcelo.matos@ufrr.br>
+LABEL maintainer="Marcelo Matos <marcelo.matos@ufrr.br>"
 
+# Dependências de runtime (SNMP CLI + daemon, SQLite, htpasswd) e as libs de
+# desenvolvimento usadas só para compilar as extensões PHP (purgadas em seguida).
 RUN apt-get update \
-    && apt-get install -y snmp php5-snmp php5-sqlite sqlite3 snmpd git apache2-utils \
+    && apt-get install -y --no-install-recommends \
+        snmp snmpd sqlite3 apache2-utils \
+        libsnmp-dev libsqlite3-dev \
+    && docker-php-ext-install snmp pdo_sqlite \
+    && apt-get purge -y --auto-remove libsnmp-dev libsqlite3-dev \
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
 
-# code
-RUN rm -rf /app && cd / && git clone https://github.com/marcelofmatos/phpnetmap.git app
+# Mesmo error_reporting do container original (suprime notices/deprecated).
+RUN { \
+        echo 'error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE'; \
+        echo 'disable_functions ='; \
+    } > /usr/local/etc/php/conf.d/custom.ini
 
-# volume for database and config
-VOLUME /app/protected/data
+# Apache: DocumentRoot em /app e AllowOverride All (rewrite e auth via .htaccess).
+RUN a2enmod rewrite \
+    && sed -ri 's!/var/www/html!/app!g; s!/var/www!/app!g' \
+        /etc/apache2/sites-available/*.conf /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf \
+    && { \
+        echo '<Directory /app>'; \
+        echo '    AllowOverride All'; \
+        echo '    Require all granted'; \
+        echo '</Directory>'; \
+    } > /etc/apache2/conf-available/phpnetmap.conf \
+    && a2enconf phpnetmap
 
+# Libera a view do snmpd local (mesma intenção do Dockerfile original).
+RUN sed -i 's/-V systemonly//g' /etc/snmp/snmpd.conf
 
-# container config
-ENV ALLOW_OVERRIDE true
-RUN a2enmod rewrite \
-    && sed -i 's/-V systemonly//g' /etc/snmp/snmpd.conf \ 
-    && echo 'error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE' > /etc/php5/mods-available/custom.ini \
-    && echo 'disable_functions = ' >> /etc/php5/mods-available/custom.ini \
-    && php5enmod custom \
-    && sed -i '2i service snmpd start' /run.sh \ 
-    && sed -i '2i /app/set_htpasswd.sh' /run.sh \
-    && chmod +x /app/set_htpasswd.sh 
+# Script de startup substitui o /run.sh do tutum (sobe snmpd, gera htpasswd).
+COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Código da aplicação a partir do checkout (respeita o .dockerignore).
+COPY . /app
+WORKDIR /app
+
+# Diretórios que precisam de escrita pelo Apache (SQLite e runtime do Yii).
+RUN chmod +x /app/set_htpasswd.sh \
+    && mkdir -p /app/protected/data /app/protected/runtime /app/assets \
+    && chown -R www-data:www-data /app/protected/data /app/protected/runtime /app/assets
+
+VOLUME /app/protected/data
+EXPOSE 80
+
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
+CMD ["apache2-foreground"]

README.md

@@ -76,6 +76,30 @@ docker logs server1
 See more in https://docs.docker.com/engine/getstarted/
 
 
+## Building the image (multi-arch)
+
+The image is built from the `Dockerfile` in this repository on top of the
+official `php:7.4-apache` base, so it runs on both **linux/amd64** and
+**linux/arm64** (Raspberry Pi, Apple Silicon, ARM servers).
+
+To build it locally for both platforms and push to a registry:
+```
+docker buildx build --platform linux/amd64,linux/arm64 \
+  -t ghcr.io/marcelofmatos/phpnetmap:dev --push .
+```
+
+To build a single-arch image for the current host and load it locally:
+```
+docker build -t phpnetmap .
+docker run -p 80:80 phpnetmap
+```
+
+Inspect the published manifest (lists `amd64` and `arm64`):
+```
+docker buildx imagetools inspect ghcr.io/marcelofmatos/phpnetmap:latest
+```
+
+
 ## Using with docker-compose
 
 Use these comands to install docker-compose

docker-entrypoint.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -e
+
+# Sobe o daemon SNMP local e gera o htpasswd antes de entregar ao Apache.
+service snmpd start || true
+/app/set_htpasswd.sh
+
+exec "$@"

set_htpasswd.sh

@@ -1,3 +1,4 @@
+#!/bin/bash
 
 if [ -z "$ADMIN_USER" ]; then
 ADMIN_USER=admin

specs/006-docker-arm64.md

@@ -2,7 +2,7 @@
 
 - **Issue:** [#6 — arm64](https://github.com/marcelofmatos/phpnetmap/issues/6)
 - **Tipo:** Feature
-- **Status:** Proposta (contém decisões em aberto — validar antes de implementar)
+- **Status:** Aprovada — decisões resolvidas (ver seção 5); pronta para implementação
 
 ## 1. Requisito
 
@@ -51,36 +51,89 @@ funcione tanto em amd64 quanto em arm64 (o Docker seleciona o manifest da
 plataforma automaticamente), **mantendo o comportamento funcional atual**
 (SNMP, SQLite, Apache + rewrite, `set_htpasswd.sh`, volume de dados).
 
-## 4. Abordagem proposta
-
-1. **Trocar a base** por uma imagem oficial multi-arch, p.ex.
-   `php:7.4-apache` ou `php:8.x-apache` (ambas publicam amd64 + arm64).
-2. **Reescrever as dependências**: instalar `snmp`, `snmpd`, `sqlite3`,
-   `apache2-utils` via apt; habilitar extensões PHP (`snmp`, `pdo_sqlite`)
-   com `docker-php-ext-install` / pacotes da distro.
-3. **`COPY . /app`** em vez de `git clone` (build a partir do checkout).
-4. **Multi-arch no CI**: adicionar `docker/setup-qemu-action` +
-   `docker/setup-buildx-action` e definir
-   `platforms: linux/amd64,linux/arm64` no `build-push-action`.
-5. **Documentar** no README o comando de build local multi-arch:
-   ```bash
-   docker buildx build --platform linux/amd64,linux/arm64 \
-     -t ghcr.io/marcelofmatos/phpnetmap:dev --push .
+## 4. Abordagem aprovada
+
+Reescrita do `Dockerfile` para uma imagem **self-contained equivalente ao
+`tutum/php-apache`**, sem depender da base descontinuada.
+
+### 4.1 Base e dependências
+
+1. **Base:** `php:7.4-apache` (Debian, multi-arch amd64+arm64, Apache + mod_php
+   já incluídos).
+2. **apt:** `snmp` (CLI + libsnmp), `snmpd` (daemon local, paridade funcional),
+   `sqlite3`, `apache2-utils` (fornece `htpasswd`). `git` sai (usamos `COPY`).
+3. **Extensões PHP:** `snmp` e `pdo_sqlite` via `docker-php-ext-install`,
+   usando `libsnmp-dev`/`libsqlite3-dev` como *build-deps* purgadas ao final
+   para enxugar a imagem (libs de runtime `libsnmp*`/`libsqlite3-0`
+   permanecem via os pacotes `snmp`/base).
+4. **`custom.ini`** em `/usr/local/etc/php/conf.d/custom.ini` reproduzindo o
+   comportamento atual:
+   ```ini
+   error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE
+   disable_functions =
    ```
 
-## 5. Decisões em aberto (precisam de validação do usuário)
-
-1. **Migração de PHP 5 → 7/8**: é a parte de maior risco. A migração da base é
-   praticamente obrigatória (não existe `tutum/apache-php` arm64 nem `php5-*`
-   nas distros atuais). É aceitável migrar para PHP 7.4/8.x? Isso pode exigir
-   ajustes no código legado (Yii 1.x roda em PHP 7.x; em PHP 8 há mais atritos).
-2. **Escopo**: entregar **imagem multi-arch publicada** (mexe na base + CI) ou
-   apenas **instruções de build** documentadas no README (escopo menor)?
-3. **Versão do PHP alvo** (7.4 vs 8.1+), considerando compatibilidade do Yii
-   1.1.x usado pelo projeto.
-4. **Reorganização do CI**: os workflows em `.github/` ainda contêm metadados de
-   outro projeto ("Fishboard", "Abstrakt Agencia") e não estão versionados.
-   Faz parte deste escopo limpá-los/versioná-los?
+### 4.2 Apache
+
+5. `a2enmod rewrite`; `DocumentRoot` → `/app`; bloco
+   `<Directory /app> AllowOverride All; Require all granted </Directory>`.
+   A aplicação **sempre** exige `AllowOverride All` (rewrite + auth do
+   `.htaccess`), então isso fica fixo — a env `ALLOW_OVERRIDE` (feature genérica
+   do tutum, não usada de fato pela app) é **removida**.
+
+### 4.3 Código, dados e permissões
+
+6. **`COPY . /app`** em vez de `git clone` (respeita o `.dockerignore`).
+7. `chown www-data` em `/app/protected/data`, `/app/protected/runtime` e
+   `/app/assets` (SQLite e Yii precisam escrever).
+8. `VOLUME /app/protected/data`; `EXPOSE 80`.
+
+### 4.4 Startup (substitui o `/run.sh` do tutum)
+
+9. Novo `docker-entrypoint.sh`:
+   ```bash
+   #!/bin/bash
+   set -e
+   service snmpd start || true
+   /app/set_htpasswd.sh
+   exec "$@"
+   ```
+   `ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]` +
+   `CMD ["apache2-foreground"]`. Mantém o `sed` no `snmpd.conf` para liberar a
+   view (`-V systemonly`).
+10. **`set_htpasswd.sh`:** adicionar shebang `#!/bin/bash` (hoje não tem; era
+    chamado de dentro do `/run.sh` do tutum).
+
+### 4.5 CI multi-arch
+
+11. **`docker-image.yml`:** converter de `docker build`/`docker push` cru para
+    `docker/setup-qemu-action` + `docker/setup-buildx-action` +
+    `docker/build-push-action` com `platforms: linux/amd64,linux/arm64`.
+12. **`release-and-build.yml`:** adicionar `setup-qemu-action`; definir
+    `platforms: linux/amd64,linux/arm64` no passo de push (o passo de
+    "build + test" com `load: true` permanece single-arch amd64, pois `load`
+    não aceita multi-arch). De passagem, corrigir os labels herdados de outro
+    projeto (`Fishboard`/`Abstrakt Agencia`) e o comando de run inválido
+    (`8080:3000` → `80:80`).
+
+### 4.6 README
+
+13. Adicionar seção curta de build local multi-arch:
+    ```bash
+    docker buildx build --platform linux/amd64,linux/arm64 \
+      -t ghcr.io/marcelofmatos/phpnetmap:dev --push .
+    ```
+
+## 5. Decisões resolvidas
+
+1. **Migração de PHP 5 → 7/8:** ✅ migrar para **PHP 7.4** (`php:7.4-apache`).
+   Melhor equilíbrio: extensões `snmp`/`pdo_sqlite` disponíveis, Yii 1.1.x roda
+   bem, e habilita arm64. PHP 8 traria mais atrito com o Yii 1.1.16 legado.
+2. **Escopo:** ✅ **completo** — Dockerfile + CI multi-arch + README.
+3. **Versão do PHP alvo:** ✅ **7.4**.
+4. **Reorganização do CI:** ✅ correções pontuais de multi-arch e dos
+   metadados/labels claramente errados (de outro projeto). Sem reorganização
+   ampla além disso.
 
 ## 6. Critérios de aceite (para a abordagem completa)