Customize Landing Page

To use a customized landing/sign-up page, create a Kustomize overlay that overrides the default landing page.

Overlay Template

To customize the landing/sign-up page, create an overlay kustomization.yaml file with the following content:

bases:
  - <path to the base sign-up directory>

configMapGenerator:
  - name: content
    behavior: replace
    files:
      - <path to new landing page>

The kustomization.yaml overlay specifies:

• bases entry, which specifies the path to the base signup directory ( <your ESS directory>/<env>/release/ess/deployment/kubernetes/bases/ess-signup/ ).

• configMapGenerator entry, which specifies the new landing page.

Procedure

To use a different landing page, create an overlay that overrides the specified configMapGenerator in the base kustomization.yaml:

In your source repository for your custom overlays,

1. Create a new directory for your overlay as described in Customize ESS. For example:

   mkdir overlay-signup-page
   cd overlay-signup-page
   

2. Place your new landing page file, for example index.html in the overlay directory.

3. In the directory, create a new kustomization.yaml with the following content (substitute your ESS directory path and environment)

   bases:
     - <your ESS directory>/<env>/release/ess/deployment/kubernetes/bases/ess-signup/
   
   configMapGenerator:
     - name: content
       behavior: replace
       files:
         - index.html
   

4. To verify the overlay, you can build the overlay and output to a file, such as kustomized.yaml, for review:

   kustomize build > kustomized.yaml
   

5. To preview the changes that will be applied to your cluster, you can use kubectl diff:

   kubectl diff -f kustomized.yaml
   

6. When you are ready, you can apply the changes to your cluster:

   kustomize apply -f kustomized.yaml
   

For more information on Kustomize, see Declarative Management of Kubernetes Objects Using Kustomize.