Main Content

mosadm push-docker-images

Push Docker images loaded from MATLAB Online Server to image registry

Since R2020a

    Description

    mosadm push-docker-images retags and pushes Docker® images loaded from the MATLAB® Online Server™ local Docker cache to the configured image registry. The mosadm command uses the Docker registry and Docker repository information from the install.config file.

    example

    mosadm push-docker-images option1 ... optionN pushes Docker images using the specified configuration options.

    Note

    mosadm push-docker-images interacts with Docker. If you do not have sudo administration privileges for Docker, then this command also requires sudo.

    Examples

    collapse all

    Update the following lines in the install.config file with your Docker registry and repository information.

    DOCKER_REGISTRY=<docker-registry-here>
    DOCKER_REPOSITORY=<repo-here>

    Push the Docker images.

    ./mosadm push-docker-images

    Alternatively, you can pass the command as a configuration option.

    ./mosadm push-docker-images --deployment-image-registry registry.yourcompany.com --deployment-image-repository mathworks

    Input Arguments

    collapse all

    One or more configuration options, specified as strings corresponding to valid configuration options from these tables.

    Specific to mosadm push-docker-images

    OptionDescription
    --deployment-image-registry registryName

    Image registry to use for the deployment.

    Example: registry.yourcompany.com

    --deployment-image-repository repositoryName

    Image repository to use for the deployment images.

    Example: mathworks

    --image-flavor imageFlavorName

    Container image flavor, specified as debian or rhel.

    Default: debian

    Common to All mosadm Commands

    OptionDescription

    --charts-dir chartsDir

    Name of the MATLAB Online Server charts folder to use. This folder contains the Helm® charts of the server.

    Specify chartsDir as an absolute path or a path relative to the MATLAB Online Server root folder mosRoot.

    Example: matlab_online_server/charts.

    Default: mosRoot/charts

    --data-dir dataDir

    Name of the MATLAB Online Server data folder to use.

    Specify dataDir as an absolute path or a path relative to the MATLAB Online Server root folder mosRoot.

    Example: matlab_online_server/data.

    Default: mosRoot/data

    --dry-run

    Print out the commands that would have run without this option specified but do not run the operation. Specify this option to test that the operation produces the expected results before actually executing it.

    --help, -h, help

    Output help for mosadm push-docker-images to the command line.

    --kube-config configFilePath

    Path to the Kubernetes® cluster configuration file. Specify configFilePath as an absolute path or a path relative to the MATLAB Online Server root folder mosRoot.

    Example: /etc/kubernetes/admin.conf

    By default, configFilePath is empty and Kubernetes obtains the cluster configuration from the KUBECONFIG environment variable (if specified) or the ~/.kube/config file. If you run mosadm push-docker-images with sudo, then ~/.kube/config is equivalent to /root/.kube/config.

    --mos-root rootDir

    MATLAB Online Server root folder, specified as an absolute path or a path relative to the current folder, that is, the folder in which you can run mosadm commands.

    Default: . (current folder)

    --overrides-dir overridesDir

    Name of the MATLAB Online Server overrides folder to use.

    Specify overridesDir as an absolute path or a path relative to the MATLAB Online Server root folder, mosRoot.

    Example: matlab_online_server/overrides

    Default: mosRoot/overrides

    --quiet, -q

    Print only the most useful or relevant output from the mosadm push-docker-images command.

    --skip-log-file

    Skip creating the install.log file and logging data about the mosadm push-docker-images operation to this file.

    --skip-prompt, -y

    Force acceptance of the terms of use for the mosadm push-docker-images and skip any command-line prompts normally provided when calling this command.

    --tmp-dir tempDirName

    Name of MATLAB Online Server temporary folder to use.

    Specify tempDirName as an absolute path or a path relative to the temporary folder.

    By default, mosadm push-docker-images generates a new temporary folder every time you run the command.

    --verbose

    Output extra details about the mosadm push-docker-images operation to the command line.

    Version History

    Introduced in R2020a