0 Fork 0

mirror of https://github.com/opensourcepos/opensourcepos.git synced 2026-10-06 17:42:05 -04:00

Files

T

jekkos 4170ed4028 feat(install): add one-line Ubuntu installer with CI test and docs

- Add scripts/install-ubuntu.sh: installs Apache/MariaDB/PHP, downloads the
  latest stable release, configures the DB + Apache, and optionally sets up
  Let's Encrypt SSL (interactive or via env vars).
- Add .github/workflows/install-script-test.yml: runs the installer in a fresh
  Ubuntu container and sanity-checks the result.
- Document the installer in INSTALL.md.
- Harden the script: identifier-safe DB_NAME, quote/pipe rejection in
  passwords, correct 'Candidate: (none)' PPA detection, keep unix_socket root
  auth when no root password is set, select the .zip release asset, and use the
  SSL domain as the public hostname for allowedHostnames.

Based on the latest master CI (build-release.yml / deploy-pr.yml left as-is).

2026-09-30 15:52:54 +02:00

build-release.yml

chore(release): unified git-cliff release workflow (changelog + tag + optional bump) (#4711 )

2026-09-24 20:49:51 +02:00

delete-unstable-release.yml

Add delete unstable release after push (#4136 )

2024-12-27 00:23:32 +01:00

deploy-core.yml

feat: Add deployment workflow with approval gates (#4522 )

2026-05-18 21:48:02 +02:00

deploy-pr.yml

fix(security): handle special characters in .env key values and improve insertion logic (#4656 )

2026-09-21 17:35:45 +02:00

deploy.yml

feat: Add deployment workflow with approval gates (#4522 )

2026-05-18 21:48:02 +02:00

install-script-test.yml

feat(install): add one-line Ubuntu installer with CI test and docs

2026-09-30 15:52:54 +02:00

main.yml

Update to CodeIgniter 4.7.2 (#4485 )

2026-04-14 01:05:10 +04:00

php-linter.yml

Update to CodeIgniter 4.7.2 (#4485 )

2026-04-14 01:05:10 +04:00

phpunit.yml

fix(security): handle special characters in .env key values and improve insertion logic (#4656 )

2026-09-21 17:35:45 +02:00

README.md

fix(ci): stop stamping app version onto master and branch Docker tags (#4709 )

2026-09-23 13:38:31 +04:00

release.yml

fix(release): keep package-lock.json version in sync on bump (#4718 )

2026-09-29 13:16:18 +02:00

README.md

GitHub Actions

This document describes the CI/CD workflows for OSPOS.

Build and Release Workflow (`.github/workflows/build-release.yml`)

Build Process

Setup PHP 8.2 with required extensions
Setup Node.js 20
Install composer dependencies
Install npm dependencies
Build frontend assets with Gulp

Docker Images

Build and push opensourcepos Docker image for multiple architectures (linux/amd64, linux/arm64)
On master: tagged master and <sha>
On other branches: tagged <branch>-<sha>
On a semver tag (e.g. 3.4.2): tagged <version> and latest
The version number is never stamped onto master/branch builds — it only appears on tag releases
Pushed to Docker Hub

Releases

Create distribution archives (tar.gz, zip)
Create/update GitHub "unstable" release on master branch only

Required Secrets

To use this workflow, you need to add the following secrets to your repository:

DOCKER_USERNAME - Docker Hub username for pushing images
DOCKER_PASSWORD - Docker Hub password/token for pushing images

How to add secrets

Go to your repository on GitHub
Click Settings → Secrets and variables → Actions
Click New repository secret
Add DOCKER_USERNAME and DOCKER_PASSWORD

The GITHUB_TOKEN is automatically provided by GitHub Actions.

Workflow Triggers

Push to master - Runs build, Docker push (master + <sha> tags), and creates/updates the unstable release
Push to other branches - Runs build and Docker push (<branch>-<sha> tag)
Push a semver tag (e.g. 3.4.2) - Runs build and Docker push (<version> + latest tags)
Pull requests - Runs build only (PHPUnit tests run in parallel via phpunit.yml); no Docker push

Existing Workflows

This repository also has these workflows:

.github/workflows/main.yml - PHP linting with PHP-CS-Fixer
.github/workflows/phpunit.yml - PHPUnit tests (runs on all PHP versions 8.1-8.4)
.github/workflows/php-linter.yml - PHP linting

Testing

PHPUnit tests are run separately via .github/workflows/phpunit.yml on every push and pull request, testing against PHP 8.1, 8.2, 8.3, and 8.4.

To test the build workflow:

Add the required secrets
Push to master or create a PR
Monitor the Actions tab in GitHub

README.md

GitHub Actions

Build and Release Workflow (.github/workflows/build-release.yml)

Build Process

Docker Images

Releases

Required Secrets

How to add secrets

Workflow Triggers

Existing Workflows

Testing

Build and Release Workflow (`.github/workflows/build-release.yml`)