Skip to main content
Version: latest

Add a Container

Palette App Mode supports the use of containers, a standard unit of software that packages code and all its dependencies to run applications quickly and reliably from one computing environment to another. Containers contain all the required executables, binary codes, libraries, and configuration files. As a result, containers are lightweight and portable with less overhead. To add a container layer to a Palette Dev Engine app profile, follow the steps below.

Prerequisite

  • Access to Palette Dev Engine App Mode.

Add Container to an App Profile

  1. Log in to Palette.

  2. From the User Menu, select Switch to App Mode.

  3. Select App Profiles in the left Main Menu and click on the New App Profile button.

  4. Provide the following basic information for your app profile and click Next.

    ParameterDescription
    App Profile NameA custom name for the app profile.
    VersionYou only need to specify a version if you create multiple versions of a profile using the same profile name. Default: 1.0.0.
    DescriptionUse the description to provide context about the profile.
    TagAssign any desired profile tags. Tags propagate to the Virtual Machines (VMs) deployed in the cloud or data center environment when apps are created from this app profile. Example: owner or region.

    To learn how to create multiple profile versions that use the same name, check out Version an App Profile.

  5. Select Container Deployment to start configuring your app profile.

  6. Provide the following configuration information for the container.

    General Settings

    ParameterDescription
    Container NameA custom name for the container.
    RegistryThe registry from which the image will be downloaded. If specifying a non-Docker Hub registry, ensure you provide the full URL of the image.
    ImageThe container image container to deploy.
    ReplicasThe number of application instances to deploy. This option follows the same behavior as a ReplicaSet in the Kubernetes configuration file. Palette supports a maximum of 10 replicas.
    info

    When adding a container image from a public DockerHub registry, you can skip the registry hostname. For instance, to download the Nginx image, specify nginx and it will be downloaded correctly during the provisioning process.

    Network Access

    ParameterDescription
    PrivateEstablishes connectivity to a container service through a private network.
    PublicEstablishes connectivity to a container service through the public network.
    PortsExposes the container for external communication.

    Environment Variables

    ParameterDescription
    Environment VariablesA key-value pair.

    Volume

    ParameterDescription
    VolumeTo persist data the container generates and uses.
    NameA custom name for the volume.
    SizeVolume size in GiB.
    Mount PathA path to access the volume.
  7. The command and arguments you provide for Runtime Settings will override the default command and arguments that the container image provides.

  8. When you have provided the required configuration information for the container, click Review. Your app profile is now created and can be deployed.

Validate

  1. Log in to Palette.

  2. From the User Menu, switch to App Mode.

  3. Click on App Profiles in the left Main Menu, and select the app profile you created to review its details.

  4. Hover your cursor over each profile layer to learn more about them, including the service name, version, and registry.

    A view of a cursor triggering the info box for each app profile layer.

    info

    Use the tool-tip that displays when you select a layer to gather information required for creating Terraform templates for app profiles. Check out our Terraform registry for Application Profiles.