Chapter 17. Managing containers by using the RHEL web console
You can use the RHEL web console web-based interface to manage your containers and pods. You can create containers in the RHEL web console as a non-root user or as a root user.
- As a root user, you can create system containers with extra privileges and options.
As a non-root user you have two options:
- Log in to the web console with limited privileges, then you can create user containers.
- Log in to the web console with administrative privileges, then you can create both types of containers - user containers and system containers.
For details about Limited access and Administrative access, see Logging in to the web console. For details about differences between root and rootless containers, see Special considerations for rootless containers.
17.1. Prerequisites
- Installed and accessible web console. See Installing the web console and Logging in to the web console.
Installed the
cockpit-podman
add-on:# dnf install cockpit-podman
17.2. Creating containers in the web console
You can create a container and add port mappings, volumes, environment variables, health checks, and so on.
Procedure
- Click Podman containers in the main menu.
- Click Create container.
- In the Name field, enter the name of your container.
Provide desired info in the Details tab.
- Available only with the administrative access: Select the Owner of the container: System or User.
In the Image drop down list select or search the container image in selected registries.
- Optional. Check the Pull latest image checkbox to pull the latest container image.
The Command field specifies the command. You can change the default command if you need.
- Optional. Check the With terminal checkbox to run your container with a terminal.
- The Memory limit field specifies the memory limit for the container. To change the default memory limit, check the checkbox and specify the limit.
- Available only for system containers: In the CPU shares field, specify the relative amount of CPU time. Default value is 1024. Check the checkbox to modify the default value.
Available only for system containers: In the Restart policy drop down menu, select one of the following options:
- No (default value): No action.
- On Failure: Restarts a container on failure.
- Always: Restarts container when exits or after system boot.
Provide desired info in the Integration tab.
Click Add port mapping to add port mapping between container and host system.
- Enter the IP address, Host port, Container port and Protocol.
Click Add volume to add volume.
- Enter the host path, Container path. You can check the Writable checkbox to create a writable volume. In the SELinux drop down list, select one of the following options: No Label, Shared or Private.
Click Add variable to add environment variable.
- Enter the Key and Value.
Provide desired info in the Health check tab.
- In the Command fields, enter the healthcheck command.
Specify the healthcheck options:
- Interval (default is 30 seconds)
- Timeout (default is 30 seconds)
- Start period
- Retries (default is 3) for the healthcheck command
- Click Create and run to create and run the container.
You can click Create to only create the container.
Verification
- Click Podman containers in the main menu. You can see the newly created container in the Containers table.
17.3. Inspecting containers in the web console
You can display detailed information on the container.
Prerequisites
- A container was created.
Procedure
- Click Podman containers in the main menu.
Click the > arrow icon to see details of the container.
In the Details tab, you can see container ID, Image, Command, Created (timestamp when the container was created), and its State.
- Available only for system containers: You can also see IP address, MAC address, and Gateway address.
- In the Integration tab, you can see environment variables, port mappings, and volumes.
- In the Log tab, you can see container logs.
- In the Console tab, you can interact with the container using the command line.
17.4. Changing the state of containers in the web console
You can change the status of the container.
Prerequisites
- A container was created.
Procedure
- Click Podman containers in the main menu.
In the Containers table, select the container you want to modify and click the overflow menu and select the action you want to perform:
- Start
- Stop
- Force stop
- Restart
- Force restart
- Pause
- Rename
17.5. Committing containers in the web console
You can create a new image based on the current state of the container.
Prerequisites
- A container was created.
Procedure
- Click Podman containers in the main menu.
- In the Containers table, select the container you want to modify and click the overflow menu and select Commit.
In the Commit container form, add the following details:
- In the New image name field, enter the image name.
- Optional: In the Tag field, enter the tag.
- Optional: In the Author field, enter your name.
- Optional: In the Command field, change command if you need.
Optional: Check the Options you need:
- Pause container when creating image: The container and its processes are paused while the image is committed.
- Use legacy Docker format: if you do not use the Docker image format, the OCI format is used.
- Click Commit.
Verification
- Click the Podman containers in the main menu. You can see the newly created image in the Images table.
17.6. Creating a container checkpoint in the web console
Using the web console, you can set a checkpoint on a running container or an individual application and store its state to disk.
Creating a checkpoint is available only for system containers.
Prerequisites
- A container is running.
Procedure
- Click Podman containers in the main menu.
- In the Containers table, select the container you want to modify and click the overflow icon menu and select Checkpoint.
Optional. In the Checkpoint container form, check the options you need:
- Keep all temporary checkpoint files: keep all temporary log and statistics files created by CRIU during checkpointing. These files are not deleted if checkpointing fails for further debugging.
- Leave running after writing checkpoint to disk: leave the container running after checkpointing instead of stopping it.
- Support preserving established TCP connections
- Click Checkpoint.
Verification
- Click the Podman containers in the main menu. Select the container you checkpointed, click the overflow menu icon and verify that there is a Restore option.
17.7. Restoring a container checkpoint in the web console
You can use data saved to restore the container after a reboot at the same point in time it was checkpointed.
Creating a checkpoint is available only for system containers.
Prerequisites
- A container was checkpointed.
Procedure
- Click Podman containers in the main menu.
- In the Containers table, select the container you want to modify and click the overflow menu and select Restore.
Optional. In the Restore container form, check the options you need:
- Keep all temporary checkpoint files: Keep all temporary log and statistics files created by CRIU during checkpointing. These files are not deleted if checkpointing fails for further debugging.
- Restore with established TCP connections
- Ignore IP address if set statically: If the container was started with IP address the restored container also tries to use that IP address and restore fails if that IP address is already in use. This option is applicable if you added port mapping in the Integration tab when you create the container.
- Ignore MAC address if set statically: If the container was started with MAC address the restored container also tries to use that MAC address and restore fails if that MAC address is already in use.
- Click Restore.
Verification
- Click the Podman containers in the main menu. You can see that the restored container in the Containers table is running.
17.8. Deleting containers in the web console
You can delete the container.
Prerequisites
- A container exists.
Procedure
- Click Podman containers in the main menu.
- In the Containers table, select the container you want to delete and click the overflow menu and select Delete.
- The pop-up window appears. Click Delete to confirm your choice.
Verification
- Click the Podman containers in the main menu. The deleted container should not be listed in the Containers table.
17.9. Creating pods in the web console
You can create pods in the RHEL web console interface.
Procedure
- Click Podman containers in the main menu.
- Click Create pod.
Provide desired information in the Create pod form:
- Available only with the administrative access: Select the Owner of the container: System or User.
- In the Name field, enter the name of your container.
Click Add port mapping to add port mapping between container and host system.
- Enter the IP address, Host port, Container port and Protocol.
Click Add volume to add volume.
- Enter the host path, Container path. You can check the Writable checkbox to create a writable volume. In the SELinux drop down list, select one of the following options: No Label, Shared or Private.
- Click Create.
Verification
- Click Podman containers in the main menu. You can see the newly created pod in the Containers table.
17.10. Creating containers in the pod in the web console
You can create a container in a pod.
Procedure
- Click Podman containers in the main menu.
- Click Create container in pod.
- Follow the steps 3.-8. in Creating containers in the web console.
The Owner of a container will be the same as the Owner of a pod.
In the pod, you can inspect containers, change the status of containers, commit containers, or delete containers.
Verification
- Click Podman containers in the main menu. You can see the newly created container in the pod under the Containers table.
17.11. Changing the state of pods in the web console
You can change the status of the pod.
Prerequisites
- A pod was created.
Procedure
- Click Podman containers in the main menu.
In the Containers table, select the pod you want to modify and click the overflow menu and select the action you want to perform:
- Start
- Stop
- Force stop
- Restart
- Force restart
- Pause
17.12. Deleting pods in the web console
You can delete the pod.
Prerequisites
- A pod exists.
Procedure
- Click Podman containers in the main menu.
- In the Containers table, select the pod you want to delete and click the overflow menu and select Delete.
- The pop-up window appears. Click Delete to confirm your choice.
All containers in a pod will be removed.
Verification
- Click the Podman containers in the main menu. The deleted pod should not be listed in the Containers table.