If this document does not correspond to your current software version, you can go to Download Center to find other available document versions.

QNAP

QNE Network 1.0.x

Download (PDF)

Managing Containers

Container Station enables you to edit some container information, reallocate resources, modify the network settings, and perform actions on your containers after you create them.

Viewing the Container Station Dashboard

The Container Station Overview screen shows a dashboard with the QNE states, CPU usage, and memory usage. The screen also displays a searchable list of the containers that were created on Container Station.

You can perform the following tasks on the Overview screen.

Task

Possible User Actions

Collapse or expand the Overview dashboard

Click or .

Select a container list

Click one of the following:

  • All: Displays a list of all containers on Container Station

  • Running: Displays only running containers

  • Stopped: Displays only stopped containers

Manage one or several containers

There are several ways to perform an action on a container.

  • On the container information screen, click a container name and then click an action button.

    For details, see Viewing the Container Information.

  • In the Actions column, click a button.

  • On the Overview or Container screen, select one or more containers and then click a button above the list.

For details, see Managing Containers.

Viewing the Container Information

The container information screen has four main areas.

Label

Area

Description

1

Container name

Displays the container name

2

Action buttons

Displays the different buttons that can be used to perform an action on the container

For details, see Managing Containers.

3

Container details

Displays the following information:

  • Status: Displays one of the following statuses.

    • Running

    • Stopped

    • Paused

    • Created

    • Dead

    • Restarting

    • Removing

  • ID: Displays the container ID

  • IP address: Displays the IP address

  • Entrypoint: Displays the entrypoint instruction

  • CPU: Displays the percentage of CPU usage

  • Image: Displays the image name and version number

  • Application: Displays the project name specified in the docker-compose.yml file

  • Port forwarding: Displays the port forwarding information

  • Command: Displays the CMD instruction

  • Memory: Displays the percentage of RAM usage

Note:

Depending on the container settings, some fields may be empty.

4

Console or Logs

Displays either the command line terminal or the container logs depending on the container settings.

The console is visible if you enabled Allocate interactive and tty processes for the container when you created the container. Otherwise, Container Station displays the logs.

Tip:

Click to open the terminal on a new tab or window.

  1. Select a method for viewing the container list.
    • On the menu, click Overview.

    • On the menu, click Container.

    The list of available containers displays.

  2. Click a container name.

    The container information screen displays.

Performing Actions on a Container

  1. Select a method for viewing the container list.
    • On the menu, click Overview.

    • On the menu, click Container.

    The list of available containers displays.

  2. Optional: Click a container name.

    The container information screen displays.

  3. Perform an action on a container.

    Task

    Description

    Steps

    Start a container

    Use this action to start a container.

    • On the Overview or Container screen:

      • In the Actions column, click .

      • Select one or more containers and then click Start.

    • On the container information screen:

      • Click Start.

    Stop a container

    Use this action to stop all processes on a running container.

    When a container is not in use, it remains on the list unless removed.

    • On the Overview or Container screen:

      • In the Actions column, click .

      • Select one or more containers and then click Stop.

    • On the container information screen:

      • Click Stop.

    Restart a container

    Use this action to restart a container.

    When a container becomes unresponsive, you can manually restart it.

    Note:

    This action is not available for all containers.

    • On the Overview or Container screen:

      • In the Actions column, click .

      • Select one or more containers and then click Restart.

    • On the container information screen:

      • Click Restart.

    Remove a container

    Use this action to remove a container.

    • On the Overview or Container screen:

      • In the Actions column, click .

      • Select one or more containers and then click Remove.

    • On the container information screen:

      • Click Remove.

    Pause a container

    Use this action to suspend all processes on a running container. When you pause a container, you can stop the service without losing some settings, such as the IP address.

    • On the Overview or Container screen:

      • Select one or more containers and then click More > Pause.

    • On the container information screen:

      • Click More > Pause.

    Resume a container

    Use this action to resume all processes on a paused container.

    • On the Overview or Container screen:

      • Select one or more containers and then click More > Resume.

    • On the container information screen:

      • Click More > Resume.

    Kill a container

    Use this action to abruptly stop a container and end all processes.

    • On the Overview or Container screen:

      • Select one or more containers and then click More > Kill.

    • On the container information screen:

      • Click More > Kill.

    Edit the container settings

    Use this action to modify the container settings.

    On the container information screen:

    1. Modify the container settings, as needed.

    2. Click Update.

      Container Station saves the changes.

    For more details on the available container settings, see Editing the Container Settings.

    Duplicate a container

    Use this action to a create a new container based on an existing container.

    Note:

    This action is only possible from the container information screen.

    1. Click More > Duplicate.

      The Create Container wizard opens.

    2. Modify or keep the default settings.

    3. Click Next.

      The Summary screen displays.

    4. Review the container settings and then click Create.

      Container Station creates the container.

    Create an image from a container

    Use this action to create a new image from an existing container.

    Note:

    This action is only possible from the container information screen.

    • Click More > Create image.

      The Create Image from Container window opens.

    • Specify the image name.

    • Specify the image version.

    • Click Create image.

    Execute a command from the terminal

    Use this action to execute commands on a running container.

    The command line terminal allows you to more easily check logs and statuses, and perform actions without using a web server.

    • On the Overview or Container screen:

      1. In the Actions column, click .

      2. Type the command.

      3. Click Connect.

    Container Station performs the specified action.

Editing the Container Settings

  1. Select a method for viewing the container list.
    • On the menu, click Overview.

    • On the menu, click Container.

    The list of available containers displays.

  2. Click a container name.

    The container information screen displays.

  3. Go to More > Edit.

    The Edit Container window opens.

  4. Modify any of the following settings.

    Field

    Possible User Actions

    Name

    Specify the container name.

    Note:

    The name must have 2 to 64 characters, starting with a letter or number, and it can only contain the following characters:

    • Letters: Upper case (A to Z) and lower case (a to z)

    • Numbers: 0 to 9

    • Special characters: hyphen (-), underscore (_), or period (.)

    Restart policy

    Select one of the following for the restart policy options.

    • None: The container does not automatically restart.

    • On failure: The container automatically restarts only if it exits due to an error.

    • Always: The container automatically restarts even if it was previously stopped.

    • Unless stopped: The container does not automatically restart if it was previously stopped.

    Note:

    The restart policy determines whether or not a container also restarts when the server or application restarts.

    CPU

    Allocate CPU resources for the container.

    1. Click Specify CPU Resources.

      The CPU window opens.

    2. Select a method.

      • Shared: The threads can be shared with other services.

      • Dedicated: The current service occupies the threads until you modify the settings.

    3. Select the number of cores and threads.

      Note:

      Click Select All to allocate all the cores and threads on the list.

    4. Click Apply.

    Important:

    You cannot configure shared and dedicated CPU resources for devices supporting less than four cores and eight threads.

    Memory

    Select whether the memory is unlimited or limited. If you select Limited, specify the memory size.

    Reserved memory

    Select whether the reserved memory is unlimited or limited. If you select Limited, specify the reserved memory size.

    Connected networks

    Connect a network to the container.

    Tip:

    While creating a network you can only select one network connection. After container creation, you can add multiple network connections.

    1. Click Connect.

      The Network Connection window appears.

    2. Select a network.

    3. Select a virtual switch from either the virtual switch or Docker network list.

    4. Select Use static IP.

    5. Specify a fixed IP address.

    6. Click Connect.

      Tip:

      To disconnect from a virtual switch, click .

  5. Click Update.

    Container Station saves the changes.