Strapi tools

v 4.x.x and above only

this is a list of bash scripts used to install, build, start and upgrade the Strapi server: This is intended to be used just after the creation of a new Strapi project, but can be added later also

installation of the package

Go to your Strapi root directory:

In Vesta servers, the path looks like this:

cd /home/$user/web/api.mydomanio.com/api/

where api is the directory that contain Strapi

see how to install Strapi from scratch for further info.

Once in your Strapi server root directory, clone this project:

First: Check that your git directory is sync with your Strapi directory

git pull 
git status
git add .
git commit -m "sync Strapi with git directory"

Add tools in .gitignore

echo "tools" >> .gitignore

Then: install your Strapi tools inside the Strapi

git clone https://git.pulsar113.org/P113/strapi_tools.git tools
cd tools
chmod +x+w install.sh build.sh start.sh upgrade.sh server.js
./install.sh

Then: sync with your git directory

git add . 
git commit -m "added strapi tools from https://git.pulsar113.org/P113/strapi_tools"
git push

Strapi tools update

When Strapi tools are installed, they are still in relation with the git repository.

Update your files , reset your permissions and relaunch the install script

cd tools
git pull
chmod +x+w install.sh build.sh start.sh upgrade.sh server.js
./install.sh

Details of the Scripts

Install

• check if pm2 is installed
• if not
• => install pm2@latest
• => run pm2 setup
• then
• => copy ecosystem.config in root directory
• => copy build.sh , start.sh, upgrade.sh in root directory

cd tools
./install.sh 

Build

This is a script that build the administration templates of the strapi server.

The Admin templates have to be rebuild when:

• strapi is updated: manually or using the upgrade script
• a new strapi generate is used to create new:
• => plugin
• => api
• => service
• => ...
• plugin, api, service or any files in directory config is modified

The script:

• set node version to the adequate value
• update NPM, PM2 and YARN to the last version
• execute git pull to update the Strapi project
• execute strapi build to build the templates

./build.sh

Upgrade

This is a script to upgrade the Strapi server to a new version

The script:

• set the node version to the adequate value
• parse the package.json file to get the current Strapi version
• check if parameter is used, and if not ask for one
• replace in package.json the Strapi version with the new version
• execute build.sh to rebuild the admin templates

The script can be used differently:

• With a parameter

./upgrade.sh 4.92

• Without parameter

./upgrade.sh

Start

This is a script to start or restart the PM2 Strapi server

The script:

• set the node version to the adequate value
• set the NODE_ENV parameter to development or production
• run pm2 update
• run pm2 start ecosystem.config.js -f --exp-backoff-restart-delay=100
• run pm2 save

./start.sh

Todo

check database configuration in the .env if not extract it from config/database.js and copy new config files