exponenta event banner

compiler.package. DockerOptions

Создание объекта параметров Docker

Описание

пример

Внимание

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

opts = compiler.package.DockerOptions(results) создает DockerOptions объект opts с использованием compiler.build.Results объект results. Results создается объектом compiler.build функция. 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';

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 объект. Используйте аргументы name-value для указания папки построения и команды точки входа.

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'

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

свернуть все

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

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

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

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

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

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

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

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

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

Пример: '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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

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

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

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

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

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

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

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

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

свернуть все

Параметры построения образа Docker, возвращенные как DockerOptions объект.

Ограничения

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

Представлен в R2020b