Algolia search

1. If you do not yet have a TeamCity configuration for building your help artifacts, set it up as described in Build on TeamCity Cloud.

2. Create a separate build configuration for publishing search indexes to your Algolia application.

   Configure it to use the following Docker image:

   registry.jetbrains.team/p/writerside/builder/algolia-publisher:2.0.32-3

   This image will run the help-publication-agent script.

3. Create a Command line type step with the following command:

   env "algolia-key=${'$'}ALGOLIA_KEY" java -jar /opt/builder/help-publication-agent.jar \ update-index \ --application-name ${'$'}ALGOLIA_APP_NAME \ --index-name ${'$'}ALGOLIA_INDEX_NAME \ --product ${'$'}CONFIG_JSON_PRODUCT \ --version ${'$'}CONFIG_JSON_VERSION \ --index-directory algolia-index/ \ 2>&1 | tee algolia-update-index-log.txt

4. In General Settings, in the Artifact path field, add algolia-update-index-log.txt to write logs.

5. In Dependencies, add artifacts produced by your help build configuration: webhelp.zip and algolia-indexes-*.zip!** => algolia-index. This action unpacks the ZIP archive with indexes to algolia-index.

6. In Parameters, add the following environment variables:

   env.ALGOLIA_APP_NAME

   Algolia application ID

   env.ALGOLIA_INDEX_NAME

   Name of Algolia index

   env.ALGOLIA_KEY

   Algolia Admin API Key.

   This is a private key. Set the type of this parameter to Password, so that users without proper permissions will not see its value.

   env.CONFIG_JSON_PRODUCT

   Help instance ID from the tree file or the value of the web-path attribute specified in writerside.cfg if it is different from the ID

   env.CONFIG_JSON_VERSION

   Help instance version (usually the same as the branch name) specified in writerside.cfg

7. Save the build configuration settings and click Deploy. After it finishes successfully, go to the index in your Algolia account and make sure that the index records have really been uploaded.

1. In your repository on GitHub, go to Settings | Secrets and variables | Actions, and add a New repository secret called ALGOLIA_KEY with the Algolia Admin API Key from your Algolia account.

2. Set up a GitHub Actions workflow that builds your help artifacts as described in Build and publish on GitHub. More specifically, make sure that you add a publish-indexes job to the workflow as described in Upload search indexes.

After you run this workflow successfully and the publish-indexes job finishes, go to the index in your Algolia account and make sure that the index records have really been uploaded.

1. In your repository on GitLab, go to Settings | CI/CD | Variables, and add a new CI/CD Variable called ALGOLIA_KEY with the Algolia Admin API Key from your Algolia account.

2. Set up a GitLab CI build pipeline that builds your help artifacts as described in Build and publish on GitLab. More specifically, make sure that you add a publish-indexes job to the workflow as described in Upload search indexes.

After you run this build pipeline successfully and the publish-indexes stage finishes, go to the index in your Algolia account and make sure that the index records have really been uploaded.