compiler.package.docker

Создайте изображение докера для файлов, сгенерированных MATLAB Compiler в операционных системах Linux

Описание

пример

Внимание

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

compiler.package.docker(results) создает изображение докера для файлов, сгенерированных MATLAB® Compiler™ с помощью compiler.build.Results объект results. Объект результатов создается a compiler.build функция.

пример

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

пример

compiler.package.docker(results,'Options',opts) создает изображение докера с помощью compiler.build.Results объект results и дополнительные опции заданы DockerOptions объект opts. Если вы используете DockerOptions объект, вы не можете задать никакие другие опции с помощью пар "имя-значение".

пример

compiler.package.docker(files,filepath,'ImageName',imageName) создает изображение докера с помощью files это сгенерировано MATLAB Compiler. Название картинки докера задано imageName.

пример

compiler.package.docker(files,filepath,'ImageName',imageName,Name,Value) создает изображение докера с помощью files это сгенерировано MATLAB Compiler. Название картинки докера задано imageName. Дополнительные опции заданы как одна или несколько пар "имя-значение".

пример

compiler.package.docker(files,filepath,'Options',opts) создает изображение докера с помощью files это сгенерировано MATLAB Compiler и дополнительными опциями, заданными DockerOptions объект opts. Если вы используете DockerOptions объект, вы не можете задать никакие другие опции с помощью пар "имя-значение".

Примеры

свернуть все

Создайте изображение докера из автономного приложения в системе Linux.

Установите и сконфигурируйте Докера в своей системе.

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

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

Results объект передается как вход compiler.package.docker функционируйте, чтобы создать изображение докера.

compiler.package.docker(buildResults);

Настройте автономное приложение с помощью пар "имя-значение" в системе Linux, чтобы задать название картинки и каталог сборки.

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

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

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

compiler.package.docker(buildResults,...
    'ImageName','mymagicapp',...
    'DockerContext','/home/mluser/Documents/MATLAB/docker');

Настройте изображение докера с помощью DockerOptions объект в системе Linux.

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

buildResults = compiler.build.standaloneApplication('hello-world.m');

Создайте DockerOptions объект задать дополнительные опции сборки, такие как название картинки.

opts = compiler.package.DockerOptions(buildResults,
    'ImageName','hellodocker',...
    'ExecuteDockerBuild','Off');

DockerOptions и Results объекты передаются как входные параметры compiler.package.docker функционируйте, чтобы создать изображение докера.

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

Создайте изображение докера с помощью файлов, сгенерированных MATLAB Compiler, и задайте название картинки в системе Linux.

Создайте автономное приложение с помощью mcc команда.

mcc -o runmyapp -m myapp.m

Создайте изображение докера путем передачи сгенерированных файлов compiler.package.docker функция.

compiler.package.docker('runmyapp','requiredMCRProducts.txt',...
    'ImageName','launchapp','EntryPoint','runmyapp');

Настройте изображение докера с помощью файлов, сгенерированных MATLAB Compiler и DockerOptions объект в системе Linux.

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

buildResults = compiler.build.standaloneApplication('helloworld.m');

Создайте DockerOptions объект задать дополнительные опции сборки, такие как папка сборки.

opts = compiler.package.DockerOptions(buildResults,...    
    'DockerContext','DockerImages')
opts = 

  DockerOptions with properties:

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

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

opts.ExecuteDockerBuild = 'Off';

Создайте изображение докера путем передачи сгенерированных файлов compiler.package.docker функция.

cd helloworldstandaloneApplication

compiler.package.docker('helloworld','requiredMCRProducts.txt',...
    'Options',opts);

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

свернуть все

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

Файлы и папки для установки в виде вектора символов, строкового скаляра, массива строк или массива ячеек строк. Эти файлы обычно генерируются продуктом MATLAB Compiler и могут также включать любые дополнительные файлы и папки, требуемые установленным приложением запускаться. Файлы, сгенерированные продуктом MATLAB Compiler в конкретном релизе, могут быть упакованы с помощью compiler.package.docker функция того же релиза.

Пример: 'myDockerFiles/'

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

Путь к requiredMCRProducts.txt файл в виде вектора символов или строкового скаляра. Этот файл сгенерирован продуктом MATLAB Compiler. Путь может быть относительно текущей рабочей директории или абсолюта.

Пример: '/home/mluser/Documents/MATLAB/magicsquare/requiredMCRProducts.txt'

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

Имя изображения докера. Это должно выполнить докера, называющего правила.

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

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

Опции докера в виде DockerOptions объект.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Типы данных: логический

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

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

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

Ограничения

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

Введенный в R2020b