BAP-22982: Move all the builds from regular to dev_container build in the master branch (Documentation) (#40932)

* BAP-22982: Move all the builds from regular to dev_container build in the master branch
- Add Documentation to dev_container. Updated app config
- Removed documentation from the regular build

---------

Co-authored-by: Viacheslav Dubrovskyi <[email protected]>

Author: OleksandrProtsiuk

.env-build

@@ -0,0 +1 @@
+ORO_IMAGE=${ORO_PROJECT}doc-application

Dockerfile

@@ -1,8 +1,26 @@
-FROM sphinxdoc/sphinx:7.1.2
+FROM sphinxdoc/sphinx:7.1.2 AS build
 
-RUN apt-get -y update
-RUN apt-get -y install git
+RUN apt-get -y update && \
+    apt-get -y install git && \
+    apt-get clean
 
 WORKDIR /documentation
-ADD requirements.txt /documentation
-RUN pip3 install -r requirements.txt
+
+COPY . .
+
+RUN pip3 install -r requirements.txt
+
+RUN rm -rf _build/html && sphinx-build -T -W --keep-going -j auto -b html . _build/html
+
+FROM scratch AS build_artifacts
+WORKDIR /
+COPY --from=build /documentation/_build/ .
+
+FROM nginx:stable-alpine-slim AS runtime
+
+LABEL org.opencontainers.image.title="Oro Documentation" \
+    org.opencontainers.image.description="Docker image for building and serving Sphinx documentation" \
+    org.opencontainers.image.authors="ORO Inc." \
+    org.opencontainers.image.vendor="ORO Inc."
+
+COPY --from=build /documentation/_build/html /usr/share/nginx/html

README.md

@@ -6,3 +6,18 @@ Documentation is published at https://doc.oroinc.com/.
 
 For the recommendations on how to setup your local environment to build documentation and how to use reStructuredText markup language to write documentation, follow the community guide on the [Oro Inc documentation website](https://doc.oroinc.com/master/community/contribute/documentation/):
 
+## Build
+
+```
+docker buildx bake --progress plain --load
+```
+
+As a result, an image and a ./_build folder will be created where the built documentation will be located.
+
+## Check
+
+The image can be launched as an instance and opened in a browser.
+
+```
+docker run --rm -p 80:80 ocir.eu-frankfurt-1.oci.oraclecloud.com/frecfpcrj6gd/oro-product-development/doc-application:latest
+```

docker-bake.hcl

@@ -0,0 +1,39 @@
+variable "ORO_PROJECT" { default = "ocir.eu-frankfurt-1.oci.oraclecloud.com/frecfpcrj6gd/oro-product-development/" }
+variable "ORO_IMAGE" { default = "${ORO_PROJECT}doc-application" }
+variable "ORO_IMAGE_TAG" { default = "latest" }
+variable "GIT_COMMIT" { default = null }
+variable "GIT_URL" { default = null }
+variable "BUILD_TIMESTAMP" { default = null }
+variable "GIT_BRANCH" { default = null }
+variable "TAG_NAME" { default = null }
+
+function "labelList" {
+  params = []
+  result = {
+    "org.opencontainers.image.revision" = "${GIT_COMMIT}"
+    "org.opencontainers.image.source"   = "${GIT_URL}"
+    "org.opencontainers.image.created"  = "${BUILD_TIMESTAMP}"
+    "com.oroinc.orocloud.reference"     = "${GIT_BRANCH}"
+    "org.opencontainers.image.version"  = "${TAG_NAME}"
+  }
+}
+
+group "default" {
+  targets = ["runtime", "build_artifacts"]
+}
+
+target "runtime" {
+  target     = "runtime"
+  dockerfile = "Dockerfile"
+  tags = [
+    "${ORO_IMAGE}:${ORO_IMAGE_TAG}",
+    "${ORO_IMAGE}:${formatdate("YYYYMMDD", timestamp())}"
+  ]
+  labels = labelList()
+}
+
+target "build_artifacts" {
+  target     = "build_artifacts"
+  dockerfile = "Dockerfile"
+  output     = ["type=local, dest=./_build"]
+}

docker-compose.yml

@@ -1,4 +1,3 @@
-version: '3.5'
 services:
   doc:
     image: oroinc/documentation:sphinx-7.1.2