feat: make it follow the standard "release branch" workflow

.github/workflows/release.yml → .github/workflows/merge_dev_to_stage.yml

@@ -1,15 +1,17 @@
-name: Release
+name: Merge dev to stage
 on:
   workflow_dispatch:
   schedule:
     - cron: '15 14 * * *'
 jobs:
-  test:
-    name: Test
-    runs-on: ubuntu-20.04
+  merge:
+    name: Merge
+    runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v3
+        with:
+          ref: 'dev'
 
       - name: Merge dev to stage
         uses: devmasx/[email protected]

.github/workflows/test.yml

@@ -58,6 +58,14 @@ jobs:
           ${{ github.ref  == 'refs/heads/dev' && vars.NETLIFY_STORYBOOK_ID != ''
           }}
 
+      - name: [silverback-template] Merge release to prod
+        uses: devmasx/[email protected]
+        if: ${{ github.repository == 'AmazeeLabs/silverback-template' && github.ref  == 'refs/heads/release'}}
+        with:
+          type: now
+          target_branch: prod
+          github_token: ${{ github.token }}
+
   docker_build:
     name: Docker Build
     if: startsWith(github.ref_name, 'test-all/')

.lagoon.yml

@@ -21,7 +21,7 @@ tasks:
         command: drush scr scripts/translations-import.php
         service: cli
 environments:
-  dev:
+  prod:
     routes:
       - nginx:
           - example.cms.amazeelabs.dev
@@ -32,3 +32,25 @@ environments:
         schedule: '*/15 * * * *'
         command: drush cron
         service: cli
+  stage:
+    routes:
+      - nginx:
+          - stage-example.cms.amazeelabs.dev
+      - build:
+          - stage-example.build.amazeelabs.dev
+    cronjobs:
+      - name: drush cron
+        schedule: '*/15 * * * *'
+        command: drush cron
+        service: cli
+  dev:
+    routes:
+      - nginx:
+          - dev-example.cms.amazeelabs.dev
+      - build:
+          - dev-example.build.amazeelabs.dev
+    cronjobs:
+      - name: drush cron
+        schedule: '*/15 * * * *'
+        command: drush cron
+        service: cli

INIT.md

@@ -37,7 +37,8 @@ Adjust project machine name in the repo.
 ```ts
 await prompt('PROJECT_NAME_MACHINE', {
   type: 'text',
-  message: 'Project name for machines:',
+  message:
+    'Project name for machines (usually a lowercase version of Jira project code):',
   validate: (name) =>
     !/^[a-z][a-z\d_]*$/.test(name)
       ? 'Must start with a lowercase letter and contain lowercase letters, numbers and underscores only.'
@@ -60,6 +61,18 @@ replace(
   '@amazeelabs/silverback-template',
   process.env.PROJECT_NAME_MACHINE,
 );
+// Template's prod domain is special.
+replace(
+  '.lagoon.yml',
+  '- example.',
+  '- prod-' + process.env.PROJECT_NAME_MACHINE + '.',
+);
+// The rest of domains are standard.
+replace(
+  '.lagoon.yml',
+  '-example.',
+  '-' + process.env.PROJECT_NAME_MACHINE + '.',
+);
 ```
 
 Update the auth key for Gatsby user.

README.md

@@ -22,14 +22,18 @@
 
 ## Release and deployment
 
-Development happens in pull requests against the `dev` branch. There is a github
-"Release" workflow that will merge the current state of `dev` into the `stage`.
-This workflow can be triggered from the github UI and will run automatically
-once a day.
-
-The "Deploy" workflow has to be triggered manually from the github UI, and will
-merge the current state of `stage` into `prod` and therefore trigger a
-production deployment.
+Default process:
+
+- Create a new branch from `release` and commit your work in
+- Create a PR against `release`
+- Merge your branch to `dev` for testing
+- Testing feedback is committed to the branch and merged back to `dev` for
+  retesting
+- When the PR is approved and Jira ticket gets to the Deploy state, the branch
+  is merged to `release`
+  - Please note, this does not trigger an actual PROD deployment
+  - If you are asked to do the actual PROD deployment, this can be done by
+    merging `release` branch into `prod`
 
 ## Installation
 
@@ -238,7 +242,7 @@ In a standard project we use three fixed Lagoon environments: `dev`, `stage` and
 - `prod`: The production environment. Do not touch.
 
 Lagoon should also be configured to create automatic environments for feature
-branches that are prefixed with `lagoon/`. Those will be filled with test
+branches that are prefixed with `lagoon-`. Those will be filled with test
 content.
 
 ## "Strangling" legacy systems