Exponenta Banner
exponenta event banner

compiler.package.DockerOptions

Создайте объект опции

Свернуть все на странице

Синтаксис

opts = compiler.package.DockerOptions(results)
opts = compiler.package.DockerOptions(results,Name,Value)
opts = compiler.package.DockerOptions('ImageName',imageName)
opts = compiler.package.DockerOptions('ImageName',imageName,Name,Value)

Описание

пример

Внимание

Эта функция поддерживается только в Linux® операционные системы.

opts = compiler.package.DockerOptions(results) создает DockerOptions opts объекта использование compiler.build.Results results объекта. The Results создается a compiler.build функция. The DockerOptions объект передается как вход в compiler.package.docker функция для задания опций сборки.

пример

opts = compiler.package.DockerOptions(results,Name,Value) создает DockerOptions opts объекта использование compiler.build.Results results объекта и дополнительные опции, заданные как одна или несколько пар аргументов имя-значение. Опции включают папку сборки, команду точки входа и имя изображения.

пример

opts = compiler.package.DockerOptions('ImageName',imageName) создает DockerOptions по умолчанию объект с именем изображения, заданным в imageName.

пример

opts = compiler.package.DockerOptions('ImageName',imageName,Name,Value) создает DockerOptions по умолчанию объект с именем изображения, заданным в imageName и дополнительные опции, заданные как одна или несколько пар аргументов имя-значение.

Примеры

свернуть все

Создайте DockerOptions объект, используя результаты сборки из автономного приложения в системе Linux.

Создайте автономное приложение с помощью magicsquare.m и сохраните результаты сборки в compiler.build.Results объект.

appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
buildResults = compiler.build.standaloneApplication(appFile);

Создайте DockerOptions объект, используя результаты построения из compiler.build.standaloneApplication функция.

opts = compiler.package.DockerOptions(buildResults);

Можно изменять значения свойств существующей DockerOptions объект с использованием записи через точку. Для примера установите папку сборки.

opts.DockerContext = 'myDockerFiles';

The DockerOptions и Results объекты передаются как входы в compiler.package.docker функция для создания Docker® изображение.

compiler.package.docker(buildResults,'Options',opts);

Создайте DockerOptions объект использует результаты сборки из автономного приложения и настраивает его с помощью аргументов имя-значение.

Создайте автономное приложение с помощью magicsquare.m и сохраните результаты сборки в compiler.build.Results объект.

appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
buildResults = compiler.build.standaloneApplication(appFile);

Создайте DockerOptions объект, используя результаты построения из compiler.build.standaloneApplication функция. Используйте аргументы имя-значение, чтобы задать имя изображения и папку сборки.

opts = compiler.package.DockerOptions(buildResults,...
    'DockerContext','Docker/MagicSquare',...
    'ImageName','magic-square-');
opts = 

  DockerOptions with properties:

            EntryPoint: 'magicsquare'
    ExecuteDockerBuild: on
             ImageName: 'magic-square-'
         DockerContext: './Docker/MagicSquare/magic-square-docker'

Создайте DockerOptions по умолчанию объект, чтобы задать имя изображения.

Создайте DockerOptions объект.

opts = compiler.package.DockerOptions('ImageName','helloworld')
opts = 

  DockerOptions with properties:

            EntryPoint: ''
    ExecuteDockerBuild: on
             ImageName: 'helloworld'
         DockerContext: './helloworlddocker'

Можно изменять значения свойств существующей DockerOptions объект с использованием записи через точку. Для примера заполните DockerContext папка без вызова 'docker build'.

opts.ExecuteDockerBuild = 'Off';
opts = 

  DockerOptions with properties:

            EntryPoint: ''
    ExecuteDockerBuild: off
             ImageName: 'helloworld'
         DockerContext: './helloworlddocker'

Создайте DockerOptions объект с именем изображения и настройка его с помощью аргументов имя-значение.

Создайте DockerOptions объект. Используйте аргументы имя-значение, чтобы задать папку сборки и команду точки входа.

opts = compiler.package.DockerOptions('ImageName','myapp-',...
    'DockerContext','Docker/MyDockerApp',...
    'EntryPoint',"exec top -b")
opts = 

  DockerOptions with properties:

            EntryPoint: 'exec top -b'
    ExecuteDockerBuild: on
             ImageName: 'myapp-'
         DockerContext: './Docker/MyDockerApp'

Входные параметры

свернуть все

Построение результатов, созданных a compiler.build функция, заданная как compiler.build.Results объект.

Имя изображения Docker. Он должен соответствовать правилам именования Docker.

Пример: 'hello-world'

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'ExecuteDockerBuild','on'

Путь к папке сборки, в которой построено изображение Docker, задается в виде вектора символов или строкового скаляра. Путь может быть относительно текущей рабочей директории или абсолютным.

Если путь не задан, функция создает папку сборки с именем ImageNameдокер в текущей рабочей директории.

Пример: 'DockerContext','/home/mluser/Documents/MATLAB/docker/magicsquaredocker'

Типы данных: char | string

Команда, которая будет выполняться при запуске изображения, заданная в виде вектора символов или строкового скаляра.

Пример: 'EntryPoint',"exec top -b"

Типы данных: char | string

Флаг для создания изображения Docker, заданный как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

  • Если вы задаете это свойство равным 'on', тогда функция создаст изображение Docker.

  • Если вы задаете это свойство равным 'off', тогда функция заполнит DockerContext папка без вызова 'docker build'.

Пример: 'ExecuteDockerBuild','Off'

Типы данных: logical

Имя изображения Docker, заданное как вектор символов или строковый скаляр. Имя должно соответствовать правилам именования Docker. Имена репозитория Docker должны быть строчными. Если основной исполняемый или архивный файл назван заглавными буквами, то прописные буквы заменяются строчными буквами в имени изображения Docker.

Пример: 'ImageName','magicsquare'

Типы данных: char | string

Выходные аргументы

свернуть все

Опции сборки изображений Docker, возвращенные как DockerOptions объект.

Ограничения

  • Только автономные приложения могут быть упакованы в изображения Docker на R2020b.

См. также

| |

Введенный в R2020b

Документация MATLAB Compiler

Поддержка