Setup CCF Runtime Environment¶

Environment Setup¶

First, follow the steps described in Install CCF.

Then, to quickly set up the dependencies necessary to start CCF applications, simply run:

SGX

$ cd /opt/ccf_sgx/getting_started/setup_vm
$ ./run.sh app-run.yml --extra-vars "platform=sgx" --extra-vars "clang_version=11"

SNP

$ cd /opt/ccf_snp/getting_started/setup_vm
$ ./run.sh app-run.yml --extra-vars "platform=snp" --extra-vars "clang_version=15"

Virtual

$ cd /opt/ccf_virtual/getting_started/setup_vm
$ ./run.sh app-run.yml --extra-vars "platform=virtual" --extra-vars "clang_version=15"

Runtime Containers¶

Pre-built runtime container images can be obtained from the Microsoft Artifact Registry. Note that none of these images are tagged as latest and so a specific version must always be specified on pull.

The runtime images do not contain any particular CCF application, and may be helpful when deploying CCF nodes via Docker, Kubernetes, etc. It is up to the operator(s) to launch the appropriate CCF application and start and manage the CCF node.

Note

The runtime images are optimised for size above all. If you need an image that comes with peripheral utilities, you probably want the Build Container instead.

C++ Apps¶

The ghcr.io/microsoft/ccf/app/run/* containers can be run to deploy C++ apps. They contain the cchost binary and the dependencies required to spin up a CCF node.

SGX

$ export VERSION="5.0.0-rc0"
$ docker pull ghcr.io/microsoft/ccf/app/run/sgx:ccf-$VERSION

SNP

$ export VERSION="5.0.0-rc0"
$ docker pull ghcr.io/microsoft/ccf/app/run/snp:ccf-$VERSION

Virtual

$ export VERSION="5.0.0-rc0"
$ docker pull ghcr.io/microsoft/ccf/app/run/virtual:ccf-$VERSION

JavaScript/TypeScript Apps¶

The ghcr.io/microsoft/ccf/app/run-js/* containers can be run to deploy JavaScript/TypeScripts apps. They contain the cchost binary, the libjs_generic native application to run JavaScript/TypeScript apps, and the dependencies required to spin up a CCF node.

SGX

$ export VERSION="5.0.0-rc0"
$ docker pull ghcr.io/microsoft/ccf/app/run-js/sgx:ccf-$VERSION

SNP

$ export VERSION="5.0.0-rc0"
$ docker pull ghcr.io/microsoft/ccf/app/run-js/snp:ccf-$VERSION

Virtual

$ export VERSION="5.0.0-rc0"
$ docker pull ghcr.io/microsoft/ccf/app/run-js/virtual:ccf-$VERSION