Tools.nasqueron.org

From Nasqueron Agora

Installation and update instructions

PHP

  • PHP 5.4+, but will evolve quickly to modern PHP 8 code (it currently runs under PHP 8.3), so look composer.json
    • Short array syntax: $properties = [];
    • Class member access on instantiation: (new ThimblController())->run();
  • The XSL extension (which depends of the libxslt library ( textproc/libxslt)
  • Composer

Nginx

The /list/replace tool generates very long Base 64 encoded permalink URL.

Add to the http block of nginx configuration (not the vhost) the following line to allow that:

   large_client_header_buffers 8 1024k

Scenario 1 - Redeploy from scratch

Note: this is currently a bad idea, as some site content isn't currently in the repository, like gadgets/rain.

su nasqueron.org
mkdir /var/wwwroot/nasqueron.org/tools
git clone git@github.com:nasqueron/tools.nasqueron.org.git
make

Scenario 2 - Deploy from tools51.nasqueron.org

Dereckson uses this to push from his staging copy and then automate scenario 3:

su
cd /home/dereckson/dev/nasqueron/tools/repo
../bin/deploy

See deploy script.

Scenario 3 - Deploy from GitHub

This is the recommended scenario.

su nasqueron.org
cd /var/wwwroot/nasqueron.org/tools
git pull
make clean all

Scenario 4 - Only update external packages

Use this when a tool packaged and fetched by composer like the source templates generator has a new revision.

su nasqueron.org
cd /var/wwwroot/nasqueron.org/tools
make clean all

If you need to fix ownership permissions

chown -R nasqueron:org:web /var/wwwroot/nasqueron.org/tools
# Enquire about the permissions for Gerrit feeds file