build content docs - in gitlab (#1619)

* build content docs - https://jira-dc.paloaltonetworks.com/browse/CIAC-7077

.gitignore

@@ -43,4 +43,7 @@ static/assets/deprecated*.json
 /src/pages/marketplace/details
 /index
 index.zip
-index.json
+index.json
+/.firebase/hosting.*.cache
+/firebase-debug.log
+/firebase_json_key.json

.gitlab/ci/.gitlab-ci.yml

@@ -0,0 +1,7 @@
+variables:
+  CURRENT_BRANCH_NAME: infra-content-docs
+
+include:
+  - file: "/.gitlab/ci/content-docs/.gitlab-ci.yml"
+    ref: $INFRA_BRANCH
+    project: "${CI_PROJECT_NAMESPACE}/infra"

.gitlab/helper_functions.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+
+CLEAR="\e[0m"
+NC='\033[0m'
+CYAN="\e[0;36m"
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+SECTION_START="\e[0Ksection_start:the_time:section_id\r\e[0K${CYAN}section_header${CLEAR}"
+SECTION_END="\e[0Ksection_end:the_time:section_id\r\e[0K"
+DATE_FMT="[%Y-%m-%dT%H:%M:%S.%3N]"
+
+section_start() {
+    local section_header section_id start
+    start="$SECTION_START"
+    if [[ "$#" -eq 1 ]]; then
+        section_header="$1"
+        section_id="$(echo "$1" | tr -c '[:alnum:]\n\r' '_')"
+    elif [[ "$#" -eq 2 ]]; then
+        if [[ "$2" =~ -{0,2}collapsed ]]; then
+            start="${start/section_id/section_id[collapsed=true]}"
+            section_header="$1"
+            section_id="$(echo "$1" | tr -c '[:alnum:]\n\r' '_')"
+        else
+            section_header="$2"
+            section_id="$1"
+        fi
+    elif [[ "$#" -eq 3 && "$3" =~ /^-{0,2}collapsed$/ ]]; then
+        start="${start/section_id/section_id[collapsed=true]}"
+        section_header="$2"
+        section_id="$1"
+    else
+        echo "section_start should be called with 1-3 args but it was called with $# args"
+        echo "acceptable usages:"
+        echo "    2. section_start \"<section-header>\""
+        echo "    4. section_start \"<section-header>\" --collapse"
+        echo "    1. section_start \"<section-start-id>\" \"<section-header>\""
+        echo "    3. section_start \"<section-start-id>\" \"<section-header>\" --collapse"
+        echo "where <section-start-id> is only alphanumeric characters and underscore and"
+        echo "--collapse indicates that you would like those log steps to be collapsed in the job log output by default"
+        exit 9
+    fi
+    start_time=$(date +%s)
+    start="$(echo "$start" | sed -e "s/the_time/$start_time/" -e "s/section_id/$section_id/" -e "s/section_header/$section_header/")"
+    echo -e "$start"
+    date +"${DATE_FMT} section start"
+}
+
+section_end() {
+    local section_id end
+    date +"${DATE_FMT} section end"
+    end="$SECTION_END"
+    if [[ "$#" -eq 1 ]]; then
+        section_id="$(echo "$1" | tr -c '[:alnum:]\n\r' '_')"
+    else
+        echo "section_end should be called with 1 arg but it was called with $# args"
+        echo "acceptable usage:"
+        echo "    1. section_end \"<section-start-id>\""
+        echo "    2. section_start \"<section-header>\""
+        echo "where <section-start-id> or <section-header> is that of the section this marks the end of"
+        exit 9
+    fi
+    end_time=$(date +%s)
+    end="$(echo "$end" | sed -e "s/the_time/$end_time/" -e "s/section_id/$section_id/")"
+    echo -e "$end"
+}
+
+job-done() {
+    mkdir -p "${PIPELINE_JOBS_FOLDER}"
+    echo "creating file ${PIPELINE_JOBS_FOLDER}/${CI_JOB_NAME}.txt"
+    echo "done" > "${PIPELINE_JOBS_FOLDER}/${CI_JOB_NAME}.txt"
+    echo "finished writing to file ${PIPELINE_JOBS_FOLDER}/${CI_JOB_NAME}.txt"
+}
+
+sleep-with-progress() {
+  local sleep_time=${1:-10}
+  local sleep_interval=${2:-1}
+  local sleep_message=${3:-"Sleeping... "}
+  local columns=${4:-$(tput cols)}
+  local sleep_step=$((sleep_time / sleep_interval))
+  for ((i=0; i< sleep_step;i++)); do echo "${sleep_interval}";sleep "${sleep_interval}"; done | poetry run tqdm --total ${sleep_time} --unit seconds --leave --update --colour green -ncols ${columns} --desc "${sleep_message}" 1> /dev/null
+}