Elastic Compute Service:Enclave CLIのサブコマンド

構文

enclave-cli build-enclave \
  --docker-uri <repository>:<tag> \
  --output-file <enclave-image-filename> \
  [ --docker-dir <path-to-dockerfile-directory> ] \
  [ --private-key <private-key> --signing-certificate <certificate> ]

パラメーター

サンプルコマンド

この例では、URIがsample:latestであるDockerイメージは、sample.eifという名前のエンクレーブイメージファイルに変換されます。

enclave-cli build-enclave --docker-uri sample:latest --output-file sample.eif

サンプル出力

Start building the Enclave Image...
Enclave Image successfully created.
{
  "Measurements": {
    "HashAlgorithm": "Sha256 { ... }",
    "PCR11": "dc5dcd841f87e2b6c0e65a11b46b25ebe2999a8a5f0318e10c0175b60000****",
    "PCR8": "2c6944f47864f1f8ab276000a9f057fcdf9f56a015c0bc5e2339f24b0000****",
    "PCR9": "8ef5fe53a7709cc1c1a0aa7b5149a55bcd524cccc9f43e7a3baf44ca0000****"
  }
}

パラメーター

構文

enclave-cli run-enclave \
  --cpu-count <vcpu-count> \
  --cpu-ids <list-of-vcpu-ids> \
  --memory <amount-of-memory-in-MiB> \
  --eif-path <enclave-image-file-path> \
  [ --enclave-cid <enclave-cid> ] \
  [ --debug-mode ] \
  [ --config <json-config-file> ]

このサブコマンドのJSON設定ファイルは、次の形式です。

{
    "cpu_count": <vcpu-count>,
    "cpu_ids": <list-of-vcpu-ids>,
    "memory_mib": <amount-of-memory-in-MiB>,
    "eif_path": "<enclave-image-file-path>",
    "enclave_cid": <enclave-cid>,
    "debug_mode": true|false
}

パラメーター

サンプルコマンド

この例では、sample.eifイメージファイルを使用して、2つのvCPUと1,024メモリのMiBが割り当てられ、10のCIDが割り当てられたエンクレーブを実行します。

enclave-cli run-enclave --cpu-count 2 --memory 1024 --eif-path sample.eif --enclave-cid 10

サンプル出力

Start allocating memory...
Started enclave with enclave-cid: 10, memory: 1024 MiB, cpu-ids: [2, 3]
{
    "EnclaveID": "12345678-1234-5678-1234-123456781234-enc1",
    "ProcessID": 1234,
    "EnclaveCID": 10,
    "NumberOfCPUs": 2,
    "CPUIDs": [
        2,
        3
    ],
    "MemoryMiB": 1024
}

パラメーター

構文

enclave-cli describe-enclaves

サンプルコマンド

この例では、実行中のエンクレーブに関する情報が照会されます。

enclave-cli describe-enclaves

サンプル出力

[
  {
    "EnclaveID": "12345678-1234-5678-1234-123456781234-enc1",
    "ProcessID": 1234,
    "EnclaveCID": 10,
    "NumberOfCPUs": 2,
    "CPUIDs": [
      2,
      3
    ],
    "MemoryMiB": 1024,
    "State": "RUNNING",
    "Flags": "DEBUG_MODE"
  }
]

パラメーター

構文

enclave-cli console --enclave-id <enclave-id>

パラメーター

サンプルコマンド

この例では、デバッグモードで実行され、12345678-1234-5678-1234-12345678 ****-enc1のIDを持つエンクレーブの出力が照会されます。

enclave-cli console --enclave-id 12345678-1234-5678-1234-12345678****-enc1

サンプル出力

コマンド出力は、カーネル起動ログとアプリケーションのランタイム出力です。 エンクレーブが期待どおりに実行されると、次のようなコマンド出力が返されます。

[   1] Hello from the enclave side!
[   2] Hello from the enclave side!
[   3] Hello from the enclave side!
...

構文

enclave-cli terminate-enclave --enclave-id <enclave-id>

パラメーター

サンプルコマンド

この例では、実行中で、12345678-1234-5678-1234-12345678 ****-enc1のIDを持つエンクレーブが終了します。

enclave-cli terminate-enclave --enclave-id 12345678-1234-5678-1234-123456781234-enc1

サンプル出力

Successfully terminated enclave 12345678-1234-5678-1234-123456781234-enc1.
{
  "EnclaveID": "12345678-1234-5678-1234-123456781234-enc1",
  "Terminated": true
}

パラメーター