Satellite Sites

How to add a new satellite

1. Create a new dataset with the name of the satellite (country) at sanity.io

2. Configure languages allowed by the new dataset in the file satellitesConfig.js

   • If needed, add a new language to the languages array.
     • Nice to have: add a flag icon for the new language in the file studio/icons/countries/index.ts.
     • Locale code list: https://www.science.co.il/language/Locale-codes.php
   • Add a new entry to the datasets array - the first value will be set as the default language.

3. Add the dataset name to the file satellites.json in the repository root

   • This triggers the creation of a docker image for both the web app and the sanity studio during the pipeline.
   • The array is read by the files .github/workflows/studio.yaml and .github/workflows/web.yaml and used as a matrix strategy for the job.

4. Create a google tag manager container for the new satellite.

   • Create a history change trigger inside the container

5. Add the necessary radix configuration to the radixconfig.yaml file, in order to run the docker image as an app in radix.

   • Add the configuration for the web instance. Find examples in the file.
   • Add the configuration for the studio instance. Find examples in the file.

6. White list features in the file FeatureFlags.js

7. Add crawlable url to the robots.txt file

8. Push changes to main and wait for GitHub actions to run

9. Add missing secrets and variables in Radix console

10. Go to manage.sanity.io and enable CORS in the API tab to the new satellite studio

    • Satellite studio url can be found in radix, or https://studio-[insertTheNewDatasetNameHere]-equinor-web-sites-[dev|preprod|prod].c2.radix.equinor.com/

11. Cookiebot configuration

    • Log in to the Cookiebot console, under Domains tab, add the new satellite site url.
    • To add a translation to the Cookiebot dialog and the Cookie declaration component, go to the Content tab, add the language variant and fill in the relevant translation text.
    • Verify that the correct language code is set for the data-culture attribute in the script tag of Cookiebot script.

12. Add roles

    • Add roles to Sanity.io
    • Add roles to Microsoft Azure
    • Create accessit group and role by creating a servicenow ticket

13. Add allowed-origins for fotoware function app

    • Add the new studio url in the allowed CORS origins to the bicep file in the internal repo and deploy azure setup in order to effect this change.