compiler.package.DockerOptions
構文
説明
は、opts
= compiler.package.DockerOptions(results
,Name,Value
)compiler.build.Results
オブジェクト results
と、1 つ以上の名前と値の引数ペアとして指定された追加オプションを使用して、DockerOptions
オブジェクト opts
を作成します。オプションには、ビルド フォルダー、エントリ ポイント コマンド、イメージ名が含まれます。
は、opts
= compiler.package.DockerOptions('ImageName',imageName
,Name,Value
)imageName
で指定されたイメージ名と、1 つ以上の名前と値の引数ペアとして指定された追加オプションを使って、既定の DockerOptions
オブジェクトを作成します。
例
ビルド結果を使用した Docker オプション オブジェクトの作成
Linux システムでスタンドアロン アプリケーションからのビルド結果を使用して、DockerOptions
オブジェクトを作成します。
magicsquare.m
を使用してスタンドアロン アプリケーションを作成し、ビルド結果を compiler.build.Results
オブジェクトに保存します。
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m'); buildResults = compiler.build.standaloneApplication(appFile);
関数 compiler.build.standaloneApplication
からのビルド結果を使用して、DockerOptions
オブジェクトを作成します。
opts = compiler.package.DockerOptions(buildResults);
ドット表記を使用して既存の DockerOptions
オブジェクトのプロパティ値を変更できます。たとえば、ビルド フォルダーを設定します。
opts.DockerContext = 'myDockerFiles';
DockerOptions
オブジェクトと Results
オブジェクトは、Docker® イメージをビルドするために、関数 compiler.package.docker
に入力として渡されます。
compiler.package.docker(buildResults,'Options',opts);
ビルド結果を使用した Docker オプション オブジェクトのカスタマイズ
スタンドアロン アプリケーションからのビルド結果を使用して DockerOptions
オブジェクトを作成し、名前と値の引数を使用してカスタマイズします。
magicsquare.m
を使用してスタンドアロン アプリケーションを作成し、ビルド結果を compiler.build.Results
オブジェクトに保存します。
appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m'); buildResults = compiler.build.standaloneApplication(appFile);
関数 compiler.build.standaloneApplication
からのビルド結果を使用して、DockerOptions
オブジェクトを作成します。名前と値の引数を使用してイメージ名とビルド フォルダーを指定します。
opts = compiler.package.DockerOptions(buildResults,... 'DockerContext','Docker/MagicSquare',... 'ImageName','magic-square-')
opts = DockerOptions with properties: EntryPoint: 'magicsquare' ImageName: 'magic-square-' RuntimeImage: '' AdditionalInstructions: {} AdditionalPackages: {} ExecuteDockerBuild: on ContainerUser: 'appuser' DockerContext: './Docker/MagicSquare' VerbosityLevel: 'verbose'
イメージ名を使用した Docker オプション オブジェクトの作成
既定の DockerOptions
オブジェクトを作成してイメージ名を指定します。
DockerOptions
オブジェクトを作成します。
opts = compiler.package.DockerOptions('ImageName','helloworld')
opts = DockerOptions with properties: EntryPoint: '' ImageName: 'helloworld' RuntimeImage: '' AdditionalInstructions: {} AdditionalPackages: {} ExecuteDockerBuild: on ContainerUser: 'appuser' DockerContext: './helloworlddocker' VerbosityLevel: 'verbose'
ドット表記を使用して既存の DockerOptions
オブジェクトのプロパティ値を変更できます。たとえば、'docker build' を呼び出さずに DockerContext
フォルダーを作成します。
opts.ExecuteDockerBuild = 'Off'
opts = DockerOptions with properties: EntryPoint: '' ImageName: 'helloworld' RuntimeImage: '' AdditionalInstructions: {} AdditionalPackages: {} ExecuteDockerBuild: off ContainerUser: 'appuser' DockerContext: './helloworlddocker' VerbosityLevel: 'verbose'
イメージ名を使用した Docker オプション オブジェクトのカスタマイズ
イメージ名を使用して DockerOptions
オブジェクトを作成し、名前と値の引数を使用してカスタマイズします。
DockerOptions
オブジェクトを作成します。名前と値の引数を使用してビルド フォルダーとエントリ ポイント コマンドを指定します。
opts = compiler.package.DockerOptions('ImageName','myapp',... 'DockerContext','Docker/MyDockerApp',... 'EntryPoint',"exec top -b")
opts = DockerOptions with properties: EntryPoint: 'exec top -b' ImageName: 'myapp' RuntimeImage: '' AdditionalInstructions: {} AdditionalPackages: {} ExecuteDockerBuild: on ContainerUser: 'appuser' DockerContext: './Docker/MyDockerApp' VerbosityLevel: 'verbose'
入力引数
results
— ビルド結果
compiler.build.Results
オブジェクト
compiler.build
関数により作成されたビルド結果。compiler.build.Results
オブジェクトとして指定します。
imageName
— Docker イメージの名前
文字ベクトル | string スカラー
Docker イメージの名前。Docker の命名規則に従っていなければなりません。
例: 'hello-world'
データ型: char
| string
名前と値の引数
オプションのペアの引数を Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定する必要がありますが、ペアの順序は考慮されません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: 'ExecuteDockerBuild','on'
AdditionalInstructions
— Docker イメージに渡す追加のコマンド
''
(既定値) | 文字ベクトル | string スカラー | 文字ベクトルの cell 配列
R2022b 以降
Docker イメージに渡す追加のコマンド。文字ベクトル、string スカラー、または文字ベクトルの cell 配列として指定します。コマンドは Dockerfile
に追加され、イメージの生成時に実行されます。
有効な Dockerfile
コマンドの詳細については、https://docs.docker.com/engine/reference/builder/
を参照してください。
例: 'AdditionalInstructions',{'RUN mkdir /myvol','RUN echo "hello world" > /myvol/greeting','VOLUME /myvol'}
データ型: char
| string
AdditionalPackages
— Docker イメージにインストールする追加のパッケージ
''
(既定値) | 文字ベクトル | string スカラー | 文字ベクトルの cell 配列
R2022b 以降
Docker イメージにインストールする追加の Ubuntu® 22.04 パッケージ。文字ベクトル、string スカラー、または文字ベクトルの cell 配列として指定します。
例: 'AdditionalPackages','syslog-ng'
データ型: char
| string
ContainerUser
— Linux ユーザーの名前
'appuser'
(既定値) | 文字ベクトル | string スカラー
R2023b 以降
Docker コンテナーを実行する Linux ユーザーの名前。文字ベクトルまたは string スカラーとして指定します。この引数はシステムのユーザー命名規約に従っていなければなりません。指定したユーザーが作成時に存在しない場合、新しいユーザーが権限なしで作成されます。このプロパティが設定されていない場合、既定ではユーザー appuser
、つまり Dockerfile
の FROM
コマンドで指定されたユーザーとしてコンテナーが実行されます。
例: 'ContainerUser','root'
データ型: char
| string
DockerContext
— ビルド フォルダーへのパス
'ImageName
docker'
(既定値) | 文字ベクトル | string スカラー
ImageName
docker'Docker イメージがビルドされるビルド フォルダーへのパス。文字ベクトルまたは string スカラーとして指定します。このパスは現在の作業ディレクトリを基準とした相対パス、または絶対パスにできます。
パスを指定しない場合、関数は
という名前のビルド フォルダーを現在の作業ディレクトリに作成します。
dockerImageName
例: 'DockerContext','/home/mluser/Documents/MATLAB/docker/magicsquaredocker'
データ型: char
| string
EntryPoint
— イメージの起動時に実行するコマンド
''
(既定値) | 文字ベクトル | string スカラー
イメージの起動時に実行するコマンド。文字ベクトルまたは string スカラーとして指定します。
例: 'EntryPoint','exec top -b'
データ型: char
| string
ExecuteDockerBuild
— Docker イメージをビルドするためのフラグ
'on'
(既定値) | on/off logical 値
Docker イメージをビルドするためのフラグ。'on'
または 'off'
、もしくは数値または logical の 1
(true
) か 0
(false
) として指定します。'on'
の値は true
と等価であり、'off'
は false
と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState
型の on/off logical 値として格納されます。
このプロパティを
'on'
に設定した場合、この関数は Docker イメージをビルドします。このプロパティを
'off'
に設定した場合、この関数は 'docker build' を呼び出さずにDockerContext
フォルダーを作成します。
例: 'ExecuteDockerBuild','Off'
データ型: logical
ImageName
— Docker イメージの名前
''
(既定値) | 文字ベクトル | string スカラー
Docker イメージの名前。文字ベクトルまたは string スカラーとして指定します。名前は Docker の命名規則に従っていなければなりません。Docker のリポジトリ名は小文字でなければなりません。メインの実行可能ファイルまたはアーカイブ ファイルの名前に大文字が使用されている場合、Docker イメージ名では大文字が小文字に置き換えられます。
例: 'ImageName','magicsquare'
データ型: char
| string
RuntimeImage
— MATLAB® Runtime イメージの名前
''
(既定値) | 文字ベクトル | string スカラー
R2023b 以降
MATLAB Runtime イメージの名前。文字ベクトルまたは string スカラーとして指定します。関数 compiler.runtime.createDockerImage
(MATLAB Compiler SDK) を使用して、複数のアプリケーションを実行できるカスタムの MATLAB Runtime イメージを作成できます。指定しない場合、MATLAB Compiler™ は、パッケージ化されたアプリケーションのみを実行できる選択的な MATLAB Runtime イメージを生成します。
例: 'RuntimeImage','mcrimage'
データ型: char
| string
VerbosityLevel
— 出力の詳細レベル
'verbose'
(既定値) | 'concise'
| 'none'
R2023b 以降
出力の詳細レベル。次のオプションのいずれかとして指定します。
'verbose'
(既定) — コマンド 'docker pull
' および 'docker build
' によって発生する Docker 出力を含むすべての画面出力を表示します。'concise'
— Docker 出力を除く進行状況の情報を表示します。'none'
— 出力を表示しません。
例: 'VerbosityLevel','concise'
データ型: char
| string
出力引数
opts
— Docker オプション オブジェクト
DockerOptions
オブジェクト
Docker イメージのビルド オプション。DockerOptions
オブジェクトとして返されます。
制限
R2020b の時点では、スタンドアロン アプリケーションのみを Docker イメージにパッケージ化できます。
バージョン履歴
R2020b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)