Container Management using LMI

Edit online

Containerized applications can be deployed and managed using the LMI.

About this task

Containers can be created and managed using this page.

Containers cannot be created until:
  1. Install the relevant container extension. For more information, see Container extensions.
  2. An image must be pulled for the installed extension using the Images tab on this page. If the image repository requires new endpoint and authentication details, use the Registry tab to create a new registry first.
Note: Container updates do not use the LMI two phase deployment model. Changes are deployed immediately once saved.

Procedure

  1. Navigate to System > Container Extensions > Containers.
  2. Click the Registries tab to manage Registry entries.
    1. To create a new Registry entry:
      1. Click New.
      2. Provide the required details and click Save.
    2. To update an existing Registry entry:
      1. Select the required registry in the list.
      2. Click Edit.
      3. Make the required changes and click Save.
    3. To delete a Registry entry:
      1. Select the required entry.
      2. Click Delete.
  3. Click the Images tab to manage container images.
    1. To pull a new container image:
      1. Click Pull.
      2. Provide the full image name. For example, icr.io/ibmappgateway/ibm-application-gateway:26.03.0 .
      3. Click the Pull button to confirm the action.
    2. To update an existing image:
      1. Select the required image in the list.
      2. Click Update.
      3. Click Yes to confirm the update.
    3. To delete an existing image:
      1. Select the image in the list.
      2. Click Delete.
  4. Click the Volumes tab to manage container volumes.
    1. To create a new empty volume:
      1. Click New.
      2. Provide the volume name.
      3. Click Save.
    2. To import files into a volume:
      1. Select the volume from the list.
      2. Click Import.
      3. Select the zip file to import. Files are extracted into the volume in the same structure and state as they exist in the zip file.
      4. Click Import.
    3. To export the files in a volume as a zip file:
      1. Select the volume from the list.
      2. Click Export.
    4. To delete a volume:
      1. Select the volume from the list.
      2. Click Delete.
  5. Click the Secrets tab to manage container secrets.
    1. To create a new secret:
      1. Click New.
      2. Provide the secret name and value.
      3. Click Save.
    2. To delete a secret:
      1. Select the secret from the list.
      2. Click Delete.
  6. Click the Containers tab to manage containers. The grid displays all existing containers and their current states.
    1. To create a new container:
      1. Click New. Note that if no extensions or images exist, an error will be displayed.
      2. Provide the container name, image to use and type.
      3. Optionally, you can also set the port mappings by selecting the Ports tab.
        Note: If the container image has no port mappings in the metadata then the Ports tab will not be shown.
        To add port mappings:
        1. Click New.
        2. Select the port name from the drop-down list.
        3. Provide the port mapping. Specify either a port number (for example 12345) or a host plus port number (for example 0.0.0.0:12345).
        4. Click Save.
      4. Optionally, you can also set the volume mappings by selecting the Volumes tab.
        Note: If the container image has not volume mappings in the metadata then the Volumes tab will not be shown.
        1. Click New.
        2. Select the volume name from the drop-down list.
        3. Select the volume from the drop-down list.
          Note: If the volume mapping is not added in the Volumes tab, it will not be shown in the drop-down list.
        4. Click Save.
      5. Optionally, you can set environment variables for the new container by selecting the Environments tab.
        1. Click New.
        2. Provide the variable name and value.
        3. Click Save.
      6. Optionally, you can set the secret mappings by selecting the Secrets tab.
        1. Click New.
        2. Select the secret from the drop-down list.
          Note: If the secret is not added in the Secrets tab, it will not be shown in the drop-down list.
        3. Provide the Target. It can be either an environment variable name or a file path.
        4. Click Save.
      7. Optionally, you can set the advanced options by selecting the Advanced tab.
        1. Select the required entry point, if the container is targeted to run as a specific entry point.
          Note: If the container image has no override entry points in the metadata then this section will not be shown.
        2. Set Arguments for the selected entry point.
        3. Update the Logging Configuration.
      8. Click Save to create the new container.
    2. To view the details of an existing container:
      1. Select the container from the list.
      2. Click View.
        Note: The View Container window displays only the added container details, for example, if no port mapping was defined when creating the container, the Ports tab will not be shown.
    3. To delete an existing container:
      1. Select the container from the list.
      2. Click Delete.
    4. To stop, start or restart an existing container:
      1. Select the container from the list.
      2. Click the Start, Stop or Restart button as required.
    5. To view the log file of an existing container:
      1. Click View in the Log column of the required container.