Deploy a new release

Mon, 01 Jan 0001 00:00:00 +0000

Follow these steps to deploy a new application release.

Prerequisites

SSH Connect access to the Essentials server
The branch/tag or build you want to deploy

1. Open SSH Connect and dev shell

Webscale CP > Accordion Menu (top left) > SSH Connect

Find the instance you want to connect to and open a terminal session by clicking on the instance link.

Then run:

dev

to jump to php-fpm container.

2. Go to the web root

All commands below are run inside this dev shell in `/var/www/html`.

cd /var/www/html

3. Update the code

Example: Git-based deployment

git fetch origin
git checkout <branch-or-tag>
git pull origin <branch-or-tag>

4. Run deployment tasks (example)

Magento

php bin/magento maintenance:enable && \
rm -rf generated/* \
var/view_preprocessed/* \
var/di/* \
var/cache/* \
var/page_cache/* \
pub/static/frontend/* \
pub/static/adminhtml/* && \
php bin/magento setup:upgrade && \
php bin/magento cache:clean && \
php bin/magento cache:flush && \
php bin/magento cache:enable && \
php bin/magento setup:di:compile && \
php -d memory_limit=2G bin/magento setup:static-content:deploy en_US -f --jobs=4 && \
php bin/magento maintenance:disable

Shopware

# Run once to install the deployment helper if it is not installed yet
composer require --no-audit shopware/deployment-helper

# Deployment commands
vendor/bin/shopware-deployment-helper run --skip-asset-install --skip-theme-compile
php bin/console database:migrate --all
php bin/console theme:compile --sync
php bin/console theme:refresh
php bin/console cache:clear
php bin/console cache:warmup

5. Verify the deployment

Load the site in a browser
Optionally check versions:

php bin/magento --version
# or
php bin/console --version

6. When to contact Webscale

Contact Webscale support if:

Magento and Shopware commands

Mon, 01 Jan 0001 00:00:00 +0000

Use the dev helper to run Magento and Shopware commands inside the application container.

1. Open SSH Connect and dev shell

In Webscale CP:

Accordion Menu (top left) > SSH Connect
Find the instance you want to connect to and open a terminal session by clicking on the instance link.

Then run:

dev

to jump to the php-fpm container.

All commands below are run inside this dev shell in `/var/www/html`.

2. Magento commands

Pattern

php bin/magento <command>

Common examples

php bin/magento cache:flush
php bin/magento indexer:reindex
php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy en_US -f --jobs=4

3. Shopware commands

Pattern

php bin/console <command>

Common examples

php bin/console database:migrate --all
php bin/console cache:clear:all
php bin/console cache:warmup
php bin/console theme:compile

Essentials on Webscale Product Documentation

Deploy a new release

Prerequisites

1. Open SSH Connect and dev shell

2. Go to the web root

3. Update the code

Example: Git-based deployment

4. Run deployment tasks (example)

Magento

Shopware

5. Verify the deployment

6. When to contact Webscale

Magento and Shopware commands

1. Open SSH Connect and dev shell

2. Magento commands

Pattern

Common examples

3. Shopware commands

Pattern

Common examples

4. Related how-to guides