Skip to main content
Skip table of contents

Controlling Docker Container

Monitoring a Docker Container

All available services are displayed in the list on the administration start page. If you want to monitor only Docker containers, filter for Source Docker:

source_filter_docker.png

The list of services will help you to check the details for a container at first sight:

service_list_docker.png

For each container, the list shows the following information:

Column Name

Description

Possible Values

Name

Name of the service. Click on the name to access the service details page.

image-20240725-100218.png

Indicates a Docker container.

Type

Indicates the type of the service.

What is the difference between pas-app and pas-service?

  • pas-app: Applications accessible via UI.

  • pas-service: Applications without UI.

  • database

  • init

  • other

  • pas-app

  • pas-nestjs

  • pas-service

  • undefined

  • xuml-legacy-service

  • xuml-service (= services created in Designer or with deployment wizard)

Other service types may be displayed.

Status

Indicates the status of the service.

Container of type init should always be in status exited.

running_service.png
starting_service.png
restarting_service.png
stopping_service.png
service_exited.png

Created/Updated

Shows the date and time of the last update of the service. If the service has not been updated yet, its creation date is displayed.

Datetime in format dd.mm.yyyy, hh:mm:ss

Version

Version tag of the Docker container.

-

Starting and Stopping a Docker Container

Use the quick actions to start, restart and stop a container. You can find the actions in the quick actions bar in the services' list…

docker_quick_actions.png

... and in the header on every container details page:

docker_details.png

Icon

Description

play_icon.png

Start a container, that is currently stopped.

restart_icon.png

Stop a running container and restart it.

stop_icon.png

Stop a running container.

Only applicable actions are enabled.

Using the Container Details

You can open a details page for each container. To do so, click on the service name in the list:

open_docker_details.png

Click on a name in the service list to open its details page. The details page shows you the title of the service and some quick actions:

Icon

Description

running_service.png

Indicates the current state of the service.

play_icon.png

Starts the service.

stop_icon.png

Stops the service.

restart_icon.png

Restarts the service.

It also contains different collapsable sections:

docker_details.png

Refer to Controlling Containerized xUML Services (Docker) for an overview on the available details of a containerized xUML service.

Information

The Information section contains the main information about the container:

  • Name

  • Source is Docker for Docker containers

  • Type

  • Created/Updated

  • Version

docker_info.png

For services of type pas-nestjs, the information section also contains a link to the Swagger UI:

docker_nestjs_info.png

Logs

In section Logs you can change the log level. Refer to Changing the Log Level of a Docker Container for detailed information.

change_docker_log_level.png

The link in section Logs gives you direct access to the Log Analyzer, where you can inspect the logs. Refer to Showing Docker Container Logs and Analyzing Platform Logs for further information.

Configuration

In the Configuration section you can change the configuration file of the container. The content of section Configuration depends on the service type.

For services of type pas-service a JSON editor is displayed (refer to Adapting Docker Container Configuration for detailed information):

pas_service_config.png

Do not edit content in the Configuration section without any knowledge of JSON.

For services of type pas-nestjs (= internal services of the PAS platform) developers can define a service-specific schema and documentation.

If a schema is available, the display in section Configuration will change and show the defined configuration options (refer to Adapting Docker Container Configuration for detailed information):

nestjs_service_configuration.png

If no schema is available, a JSON editor is displayed in section Configuration:

nestjs_service_configuration_without_schema.png

Do not edit content in the Configuration section without any knowledge of JSON.

The Configuration section also informs you if the configuration UI is not available for a service type:

no_configuration_available.png
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.