|
4 | 4 |
|
5 | 5 | Template repository for JavaScript and C++ CCF applications.
|
6 | 6 |
|
7 |
| -Note: For complete sample apps, see https://github.com/microsoft/ccf-app-samples. |
| 7 | +Note: For complete sample apps, see https://github.com/microsoft/ccf-app-samples. |
8 | 8 |
|
9 | 9 | ## Quickstart
|
10 | 10 |
|
11 |
| -The quickest way to build and run this sample CCF app is to checkout this repository locally in its development container by clicking: |
| 11 | +The quickest way to build and run this sample CCF app is to checkout this repository locally in its development container by clicking: |
12 | 12 | [](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/microsoft/ccf-app-template)
|
13 | 13 |
|
14 | 14 | All dependencies will be automatically installed (takes ~2 mins on first checkout).
|
@@ -85,29 +85,28 @@ To start a test CCF network on a Linux environment, it requires [CCF to be intal
|
85 | 85 | # Start the CCF network using the cchost in
|
86 | 86 |
|
87 | 87 | # Enclave mode
|
88 |
| - /opt/ccf/bin/cchost --config ./config/cchost_config_enclave_js.json |
| 88 | + /opt/ccf_sgx/bin/cchost --config ./config/cchost_config_enclave_js.json |
89 | 89 |
|
90 | 90 | # Or Virtual mode
|
91 |
| -/opt/ccf/bin/cchost --config ./config/cchost_config_virtual_js.json |
| 91 | +/opt/ccf_virtual/bin/cchost --config ./config/cchost_config_virtual_js.json |
92 | 92 | ...
|
93 | 93 |
|
94 | 94 | # Now the CCF network is started and further initialization needed before the interaction with the service
|
95 | 95 | ```
|
96 | 96 |
|
97 | 97 | The CCF network is started with one node and one member, please follow the [same governance steps as Docker](#network-governance) to initialize the network and check [CCF node config file documentation](https://microsoft.github.io/CCF/main/operations/configuration.html)
|
98 | 98 |
|
99 |
| - |
100 | 99 | ### Managed CCF
|
101 | 100 |
|
102 |
| -The application can be tested using [Azure Managed CCF](https://techcommunity.microsoft.com/t5/azure-confidential-computing/microsoft-introduces-preview-of-azure-managed-confidential/ba-p/3648986) ``(Pre-release phase)``, you can create Azure Managed CCF service on your subscription, that will give you a ready CCF network |
| 101 | +The application can be tested using [Azure Managed CCF](https://techcommunity.microsoft.com/t5/azure-confidential-computing/microsoft-introduces-preview-of-azure-managed-confidential/ba-p/3648986) `(Pre-release phase)`, you can create Azure Managed CCF service on your subscription, that will give you a ready CCF network |
103 | 102 |
|
104 | 103 | - First, create the network's initial member certificate, please check [Certificates generation](https://microsoft.github.io/CCF/main/governance/adding_member.html)
|
105 | 104 | - Create a new Azure Managed CCF service (the initial member certificate required as input)
|
106 | 105 | - Build the application and [create a deployment proposal](https://microsoft.github.io/CCF/main/build_apps/js_app_bundle.html#deployment)
|
107 | 106 | - Deploy the application proposal, [using governance calls](https://microsoft.github.io/CCF/main/governance/proposals.html#creating-a-proposal)
|
108 | 107 | - Create and submit [an add users proposal](https://microsoft.github.io/CCF/main/governance/proposals.html#creating-a-proposal)
|
109 | 108 |
|
110 |
| -## <img src="https://user-images.githubusercontent.com/42961061/191275172-24269bf0-bb9c-402d-8900-2d589582a781.png" height=50px></img> C++ |
| 109 | +## <img src="https://user-images.githubusercontent.com/42961061/191275172-24269bf0-bb9c-402d-8900-2d589582a781.png" height=50px></img> C++ |
111 | 110 |
|
112 | 111 | CCF apps can also be written in C++. This offers better performance than JavaScript apps but requires a compilation step and a restart of the CCF node for deployment.
|
113 | 112 |
|
@@ -175,13 +174,15 @@ $ docker run ccf-app-template:cpp-virtual
|
175 | 174 | If this repository is checked out on a bare VM (e.g. [for SGX deployments](https://docs.microsoft.com/en-us/azure/confidential-computing/quick-create-portal)), the dependencies required to build and run the C++ app can be installed as follows:
|
176 | 175 |
|
177 | 176 | ```bash
|
178 |
| -$ wget https://github.com/microsoft/CCF/releases/download/ccf-4.0.14/ccf_virtual_4.0.14_amd64.deb |
179 |
| -$ sudo dpkg -i ccf_virtual_4.0.14_amd64.deb # Install CCF under /opt/ccf |
180 |
| -$ cat /opt/ccf_virtual/share/VERSION_LONG |
181 |
| -ccf-4.0.14 |
182 |
| -$ /opt/ccf/getting_started/setup_vm/run.sh /opt/ccf/getting_started/setup_vm/app-dev.yml # Install dependencies |
| 177 | +$ wget https://github.com/microsoft/CCF/releases/download/ccf-5.0.0/ccf_sgx_5.0.0_amd64.deb |
| 178 | +$ sudo dpkg -i ccf_sgx_5.0.0_amd64.deb # Install CCF under /opt/ccf_sgx |
| 179 | +$ cat /opt/ccf_sgx/share/VERSION_LONG |
| 180 | +ccf-5.0.0 |
| 181 | +$ /opt/ccf_sgx/getting_started/setup_vm/run.sh /opt/ccf_sgx/getting_started/setup_vm/app-dev.yml # Install dependencies |
183 | 182 | ```
|
184 | 183 |
|
| 184 | +For a non-SGX VM, replace `ccf_sgx` in all the commands above with `ccf_virtual`. |
| 185 | + |
185 | 186 | See the [CCF official docs](https://microsoft.github.io/CCF/main/build_apps/install_bin.html#install-ccf) for more info and [Modern JavaScript application development](https://microsoft.github.io/CCF/main/build_apps/js_app_bundle.html).
|
186 | 187 |
|
187 | 188 | ## Code Tour
|
|
0 commit comments