ktl-812 chore: build configuration for api references customization tests

Author: nikpachoo

.dockerignore

@@ -1,7 +1,6 @@
 .github
 .idea
 .next
-_assets
 build
 node_modules
 out

.teamcity/tests/TestsProject.kt

@@ -8,5 +8,6 @@ object TestsProject : Project({
 
   buildType(tests.buildTypes.E2ETests)
   buildType(tests.buildTypes.E2EProductionTest)
+  buildType(tests.buildTypes.ApiReferencesTemplateTest)
 })
 

.teamcity/tests/buildTypes/ApiReferencesTemplateTest.kt

@@ -0,0 +1,77 @@
+package tests.buildTypes
+
+import jetbrains.buildServer.configs.kotlin.BuildType
+import jetbrains.buildServer.configs.kotlin.FailureAction
+import jetbrains.buildServer.configs.kotlin.buildFeatures.PullRequests
+import jetbrains.buildServer.configs.kotlin.buildFeatures.pullRequests
+import jetbrains.buildServer.configs.kotlin.buildSteps.script
+import jetbrains.buildServer.configs.kotlin.triggers.vcs
+
+object ApiReferencesTemplateTest: BuildType({
+  name = "Api References Template Test"
+
+  vcs {
+    root(vcsRoots.KotlinLangOrg)
+  }
+
+  triggers {
+    vcs {
+      branchFilter = "+:pull/*"
+    }
+  }
+
+  steps {
+    script {
+      scriptContent = "./scripts/dokka/up.sh"
+    }
+
+    script {
+      scriptContent = "./scripts/dokka/run.sh"
+    }
+
+    script {
+      scriptContent = "./scripts/dokka/stop.sh"
+    }
+  }
+
+  requirements {
+    exists("docker.server.version")
+    contains("docker.server.osType", "linux")
+  }
+
+  features {
+    pullRequests {
+      vcsRootExtId = "${vcsRoots.KotlinLangOrg.id}"
+      provider = github {
+        authType = token {
+          token = "%github.oauth%"
+        }
+        filterAuthorRole = PullRequests.GitHubRoleFilter.MEMBER_OR_COLLABORATOR
+      }
+    }
+  }
+
+  dependencies {
+    dependency(builds.apiReferences.buildTypes.KotlinxCoroutines) {
+      snapshot {
+        onDependencyFailure = FailureAction.CANCEL
+        onDependencyCancel = FailureAction.CANCEL
+      }
+
+      artifacts {
+        artifactRules = "+:pages.zip!** => libs/kotlinx.coroutines/"
+      }
+    }
+
+    dependency(builds.apiReferences.buildTypes.KotlinxSerialization) {
+      snapshot {
+        onDependencyFailure = FailureAction.CANCEL
+        onDependencyCancel = FailureAction.CANCEL
+      }
+
+      artifacts {
+        artifactRules = "+:pages.zip!** => libs/kotlinx.serialization/"
+      }
+    }
+  }
+})

dockerfiles/nginx-server/Dockerfile

@@ -0,0 +1,6 @@
+FROM nginx:latest
+
+WORKDIR /var/www
+
+COPY libs /usr/share/nginx/html/api
+COPY _assets /usr/share/nginx/html/_assets

dockerfiles/playwright/Dockerfile

@@ -0,0 +1,12 @@
+FROM mcr.microsoft.com/playwright:v1.22.2-focal
+
+WORKDIR /var/www
+
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile
+
+COPY ./scripts ./scripts
+COPY playwright.config.js .
+COPY ./test ./test
+
+ENTRYPOINT ["tail", "-f"]

scripts/dokka/run-tests.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -e
+set +x
+set -o pipefail
+set -u
+
+echo "Waiting for the $BASE_URL response"
+
+./scripts/test/wait-for-endpoint.sh "$BASE_URL"
+
+yarn run test:visual:ci

scripts/dokka/run.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -e
+set +x
+set -o pipefail
+set -u
+
+cd "$(pwd)" || exit 1
+
+PLAYWRIGHT_CONTAINER_NAME="kotlin-web-site_playwright"
+
+docker exec -i "$PLAYWRIGHT_CONTAINER_NAME" /bin/bash -c "./scripts/dokka/run-tests.sh"

scripts/dokka/stop.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -e
+set +x
+set -o pipefail
+set -u
+
+APP_CONTAINER_NAME="kotlin-web-site_nginx-server"
+PLAYWRIGHT_CONTAINER_NAME="kotlin-web-site_playwright"
+
+docker stop "$APP_CONTAINER_NAME"
+docker rm "$APP_CONTAINER_NAME"
+
+docker stop "$PLAYWRIGHT_CONTAINER_NAME"
+docker rm "$PLAYWRIGHT_CONTAINER_NAME"

scripts/dokka/up.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -e
+set +x
+set -o pipefail
+set -u
+
+cd "$(pwd)" || exit 1
+
+APP_CONTAINER_NAME="kotlin-web-site_nginx-server"
+PLAYWRIGHT_CONTAINER_NAME="kotlin-web-site_playwright"
+
+docker build -t "$APP_CONTAINER_NAME" -f ./dockerfiles/nginx-server/Dockerfile .
+
+docker run -d -p 8080:80 --name "$APP_CONTAINER_NAME" "$APP_CONTAINER_NAME"
+
+docker build -t "$PLAYWRIGHT_CONTAINER_NAME" -f ./dockerfiles/playwright/Dockerfile .
+
+APP_CONTAINER_IP=$(docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "$APP_CONTAINER_NAME")
+
+docker run -d -e BASE_URL="http://$APP_CONTAINER_IP" -e ipc=host -v $(pwd)/test/snapshots:/var/www/test/snapshots --name "$PLAYWRIGHT_CONTAINER_NAME" "$PLAYWRIGHT_CONTAINER_NAME"