Manufacturing Connect User UI
...
Application Releases
Add a Draft Application Releas...
Set Up Docker Container Configurations for an Application Release
14min
an application release must contain at least one component ( containers / containers advanced ) or a compose configuration file ( compose ) although it is possible to submit a docker application release without at least one component ( containers / containers advanced ) or a compose configuration file ( compose ), the docker application release cannot be later deployed to a manufacturing connect edge instance the component or the compose configuration file sets up a configuration to extract at least one docker image from a docker repository to execute the docker image's respective docker container this allows the docker application release to package multiple docker images (and the respective docker containers) and deliver them to manufacturing connect edge instances concurrently it is these docker images from the component/compose configuration file that will be later deployed as docker images to manufacturing connect edge instances during deploy an application to edge devices docid 6gp9vk1jyhrffxzdsx6hp option 1 containers set up a component see the following on how to add/manage components for the containers tab action details \[1] show filter / hide filter search by name , image \[2] add component you can add multiple components you can't add variables for a submitted application release \[3] action menu edit you can't edit components for a submitted application release remove you can't delete components for a submitted application release more on add component when adding a new component, a docker image must be extracted from a docker registry the other available customizations enable additional configurations when executing the docker container from the extracted docker image furthermore, when customizing the docker image configurations, it is also possible to use the variables created from set up variables for an application release docid 1li4sn 6xts17xpvntm9z as values the syntax for referring to these variables is ${variable name} where variable name is the name of the variable being used step 1 set up common parameters in this section, you will set up the initial configuration needed for a docker image’s respective docker container name assign a name for docker container see assign name for details repository the available registry provider of the docker image see registry management docid\ fsbyl1vadqa7kmbqoz4qh and docker registry for details image the docker image registry location for a docker pull command see pull from a different registry for details the image registry location must be both a valid registry location and accessible by manufacturing connect edge instances restart the restart policy for the equivalent docker container see use a restart policy for details network mode the network settings for the equivalent docker container see network settings for details enable tty see tty or t of options and allocate pseudo tty for details open stdin see the interactive or i option of options and allocate pseudo tty for details privileged see full container capabilities for details command the command line arguments used by the docker container’s application when it executes step 2 set up environment in this section, you can set up the environment variables that the docker container will use during its operation see environment variables for details step 3 set up labels in this section you can set up metadata to the docker container see set metadata on container for details step 4 set up ports in this section, you can set up the port management for the docker container see ports for details step 5 set up volumes in this section, you can set up the data persistence mechanism for the docker container see use volumes or use bind mounts for details option 2 containers advanced set up a component this option is an upgraded version of option 1 containers set up a component see the following on how to add/manage components for the containers advanced tab action details \[1] show filter / hide filter search by name , image \[2] add component you can add multiple components you can't add variables for a submitted application release \[3] action menu edit you can't edit components for a submitted application release remove you can't delete components for a submitted application release more on add component in option 1 containers set up a component , there are five steps where you may enter details for a pre determined set of basic docker parameters the limitation of the previous option is that it is not possible to access and configure the remaining more advanced docker parameters when adding a new component, this second option offers a json configuration form to access and configure the remaining advanced docker parameters the form will be used to request a docker image from a selected docker registry step 1 set up common parameters the first step is a simplified version of the step 1 set up common parameters section from the previous option name assign a name for docker container assign name for details repository the available registry provider of the docker image see registry management docid\ fsbyl1vadqa7kmbqoz4qh and docker registry for details step 2 insert container create configuration json file the second step allows you to create a docker container by entering file contents for a docker container configuration json file see create a container for details furthermore, when customizing the json file, it is also possible to use the variables created from set up variables for an application release docid 1li4sn 6xts17xpvntm9z as values the syntax for referring to these variables is ${variable name} where variable name is the name of the variable being used action details \[1] import component config load the component configuration from an external source \[2] copy config content duplicate the current configuration content to the clipboard \[3] paste config content insert the previously copied configuration content into the designated area \[4] clear config content remove all existing configuration content from the input field \[5] link to api specifications for creating a container access documentation detailing the api procedures for container creation \[6] enter config content input the configuration settings manually into the designated field option 3 compose set up a compose this option is an even more upgraded version of the previous two options in the form of an alternative compose subsection rather than creating a component one by one like the previous two options, you are able to set up multiple components all at once by entering a yaml compose file to set up a multi container application configuration see compose specifications for details furthermore, when customizing the yaml file, it is also possible to use the variables created from set up variables for an application release docid 1li4sn 6xts17xpvntm9z as values the syntax for referring to these variables is ${variable name} where variable name is the name of the variable being used action details \[1] import compose file allows users to upload a compose file for processing \[2] copy compose file facilitates the duplication of a selected compose file \[3] paste compose file enables the insertion of a copied compose file into the designated location \[4] clear compose file removes all content from the current compose file \[5] link to compose file format in compose specifications provides access to the official specifications for compose file formatting \[6] compose file contents displays the data and configuration included within the selected compose file \[7] view supported compose objects lists all objects that are compatible with the compose file format when you click supported compose objects, a list of all the supported objects displays from the right when you attempt to save a yaml compose file with unsupported compose objects, an error such as the following appears it will indicate all the invalid fields