HD-27769-Documented how to run PSMDB-pro in Docker (#1033) (#1037)

HD-27769-Documented how to run PSMDB-pro in Docker



---------

Co-authored-by: radoslawszulgo <radoslaw.szulgo@percona.com>

Author: nastena1606

docs/install/docker.md

@@ -42,7 +42,26 @@ and restart it if the container exits.
 * `percona/percona-server-mongodb` is the name of the image to derive the container from.
 
 * `<TAG>` is the tag specifying the version you need. For example, `{{release}}`. Docker automatically identifies the architecture (x86_64 or ARM64) and pulls the respective image. [See the full list of tags](https://hub.docker.com/r/percona/percona-server-mongodb/tags).
-    
+
+## Access container shell
+
+--8<-- [start:shell]
+
+Run the following command to start the bash session and run commands inside the container:
+
+```{.bash data-prompt="$"}
+$ docker exec -it <container-name>
+```
+
+where `<container-name>` is the name of your database container.
+
+For example, to connect to Percona Server for MongoDB, run:
+
+```{.bash data-prompt="$"}
+$ mongosh
+```
+--8<-- [end:shell]
+
 ## Connecting from another Docker container
 
 The Percona Server for MongoDB container exposes standard MongoDB port (27017),
@@ -57,8 +76,6 @@ For example, to set up a replica set for testing purposes, you have the followin
 
 The following example demonstrates the setup on x86_64 platforms. The `rs101`, `rs102`, `rs103` are the container names for Percona Server for MongoDB and `rs` is the replica set name. 
 
-For ARM64 architectures, change the image to `percona/percona-server-mongodb:<TAG>-arm64`.
-
 === "Bridge network"
 
     When you start Docker, a default `bridge` network is created and all containers are automatically attached to it unless otherwise specified. 
@@ -249,3 +266,8 @@ You can get the IP address by running this command:
 $ docker inspect -f '{{range.NetworkSettings.Networks}}{{.IPAddress}}{{end}}' psmdb
 ```
 {% endraw %}
+
+## Next steps
+
+[Run simple queries :material-arrow-right:](../crud.md){.md-button}
+

docs/install/install-pro.md

@@ -149,6 +149,65 @@ The steps below describe the installation on Ubuntu 22.04. Replace the link to t
 5. Make sure that you have read and write permissions for the data
 directory and run `mongod`.
 
+## Run Percona Server for MongoDB Pro in Docker
+
+You can run Percona Server for MongoDB Pro in Docker using the official image available in a private registry on [Docker Hub](https://hub.docker.com/r/percona/percona-server-mongodb-pro).
+
+We gather [Telemetry data](../telemetry.md) to understand the use of the software and improve our products.x
+
+To access this image, you must authenticate in DockerHub. For this you must have a valid Percona Server for MongoDB Pro subscription. 
+
+### Authenticate in Docker Hub
+
+1. Contact your Percona Representative to get authentication credentials for Docker Hub. You will receive a username and an access token. 
+2. Authenticate in Docker Hub:
+
+    ```{.bash data-prompt="$"}
+    $ docker login --username <Username> 
+    ```
+    
+    When prompted for a password, enter your access token.
+
 ## Next steps
 
 [Connect to MongoDB :material-arrow-right:](../connect.md){.md-button}
+
+
+### Run Percona Server for MongoDB Pro
+
+To run Percona Server for MongoDB Pro in Docker, use the following command:
+
+```{.bash data-prompt="$"}
+$ docker run -d --name psmdb-pro -p 27017:27017 --restart always percona/percona-server-mongodb-pro:<TAG>
+```
+
+The command does the following:
+
+* The `docker run` command instructs the `docker` daemon
+to run a container from an image.
+
+* The `-d` option starts the container in detached mode
+(that is, in the background).
+
+* The `--name` option assigns a custom name for the container
+that you can use to reference the container within a Docker network.
+In this case: `psmdb-pro`.
+
+* The `-p` option binds the container's port `27017` to TCP port `27017` on all host network interfaces. This makes the container accessible externally.
+
+* The `--restart` option defines the container’s restart policy.
+Setting it to `always` ensures that the Docker daemon
+will start the container on startup
+and restart it if the container exits.
+
+* `percona/percona-server-mongodb-pro` is the name of the image to derive the container from.
+
+* `<TAG>` is the tag specifying the version you need. For example, `{{release}}`. Docker automatically identifies the architecture (x86_64 or ARM64) and pulls the respective image. [See the full list of tags](https://hub.docker.com/r/percona/percona-server-mongodb-pro/tags).
+
+### Access the container shell
+
+--8<-- "docker.md:shell"
+
+## Next steps
+
+[Run simple queries :material-arrow-right:](../crud.md){.md-button}

docs/psmdb-pro.md

@@ -4,7 +4,7 @@ Percona Server for MongoDB Pro is a build of Percona Server for MongoDB that con
 
 [Become a Percona Customer](https://www.percona.com/about/contact){.md-button}
 
-Non-paying Percona software users can also benefit from Percona Pro Builds, but they’ll have to [build them from the source code](install/source.md) provided by Percona and available to everyone.
+Non-paying Percona software users can also benefit from Percona Pro Builds, but they'll have to [build them from the source code](install/source.md) provided by Percona and available to everyone.
 
 ## Features
 
@@ -13,7 +13,7 @@ Find the list of solutions available in Percona Server for MongoDB Pro builds:
 | Name                                | Version added | Description  | 
 | ----------------------------------- | ------------- | -------------
 | [FIPS support ](fips.md)| 8.0.4-1 | FIPS mode provides a way to use FIPS-compliant encryption and run the Percona Server for MongoDB with the FIPS-140 certified library for OpenSSL. This helps customers meet minimum security requirements for cryptographic modules and testing in both hardware and software. |
-| Binaries with debug symbols | 8.0.8-3](release_notes/8.0.8-3.md) | By including debug symbols in the binary, Percona Server for MongoDB enables deeper integration with monitoring agent-based solutions. These agents can instrument the binary at runtime, providing more detailed telemetry data, such as performance metrics, error tracking, and function-level diagnostics. This enhanced observability allows for better monitoring of system health, faster identification of issues, and more granular insights into how the application performs in production environments.<br> Including this information empowers teams to respond proactively to performance bottlenecks, optimize resource allocation, and improve the overall stability of the application with real-time insights. |
+| Binaries with debug symbols | [8.0.8-3](release_notes/8.0.8-3.md) | By including debug symbols in the binary, Percona Server for MongoDB enables deeper integration with monitoring agent-based solutions. These agents can instrument the binary at runtime, providing more detailed telemetry data, such as performance metrics, error tracking, and function-level diagnostics. This enhanced observability allows for better monitoring of system health, faster identification of issues, and more granular insights into how the application performs in production environments.<br> Including this information empowers teams to respond proactively to performance bottlenecks, optimize resource allocation, and improve the overall stability of the application with real-time insights. |
 
 
 ## Benefits

mkdocs-base.yml

@@ -109,7 +109,9 @@ markdown_extensions:
       linenums: false
   pymdownx.inlinehilite: {}
   pymdownx.snippets:
-      base_path: ["snippets"]
+      base_path: 
+        - snippets
+        - docs/install
 #       auto_append:
 #         - services-banner.md
   pymdownx.tasklist: