Merge pull request #258452 from taicchoumsft/tachou/mccf-fix-typescript-init-and-scripts

[MCCF][Typescript Quickstart] Fix typescript init and scripts

Author: JamesJBarnett

articles/managed-ccf/quickstart-typescript.md

@@ -31,20 +31,30 @@ This quickstart uses the Azure Identity library, along with Azure CLI or Azure P
 
 [!INCLUDE [Sign in to Azure](../../includes/confidential-ledger-sign-in-azure.md)]
 
-### Install the packages
-
-In a terminal or command prompt, create a suitable project folder, and then create and activate a Python virtual environment as described on [Use Python virtual environments](/azure/developer/python/configure-local-development-environment?tabs=cmd#use-python-virtual-environments).
+### Initialize a new npm project
+In a terminal or command prompt, create a suitable project folder and initialize an `npm` project. You may skip this step if you have an existing node project. 
+```terminal
+cd <work folder>
+npm init -y
+```
 
+### Install the packages
 Install the Azure Active Directory identity client library.
 
 ```terminal
-npm install @azure/identity
+npm install --save @azure/identity
 ```
 
 Install the Azure Confidential Ledger management plane client library.
 
 ```terminal
-npm install @azure/[email protected]
+npm install -save @azure/[email protected]
+```
+
+Install the TypeScript compiler and tools globally
+
+```terminal
+npm install -g typescript
 ```
 
 ### Create a resource group
@@ -63,38 +73,51 @@ npm install @azure/[email protected]
 
 ### Use the Management plane client library
 
-The Azure SDK for JavaScript and TypeScript library (azure/arm-confidentialledger) allows operations on Managed CCF resources, such as creation and deletion, listing the resources associated with a subscription, and viewing the details of a specific resource. The following piece of code creates and views the properties of a Managed CCF resource.
+The Azure SDK for JavaScript and TypeScript library [azure/arm-confidentialledger](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/confidentialledger/arm-confidentialledger) allows operations on Managed CCF resources, such as creation and deletion, listing the resources associated with a subscription, and viewing the details of a specific resource. 
+
+To run the below samples, please save the code snippets into a file with a `.ts` extension into your project folder and compile it as part of your TypeScript project, or compile the script into JavaScript separately by running:
 
-```JavaScript
+```terminal
+tsc <filename.ts>
+```
+
+The compiled JavaScript file will have the same name but a `*.js` extension. Then run the script in nodeJS:
+```terminal
+node <filename.js>
+```
+
+The following sample TypeScript code creates and views the properties of a Managed CCF resource.
+
+```TypeScript
 import  { ConfidentialLedgerClient, ManagedCCFProperties, ManagedCCF, KnownLanguageRuntime, DeploymentType, MemberIdentityCertificate } from "@azure/arm-confidentialledger";
 import { DefaultAzureCredential } from "@azure/identity";
-import { Console } from "console";
 
-const subscriptionId = "0000000-0000-0000-0000-000000000001"; // replace
+// Please replace these variables with appropriate values for your project
+const subscriptionId = "0000000-0000-0000-0000-000000000001";
 const rgName = "myResourceGroup";
-const ledgerId = "confidentialbillingapp";
+const ledgerId = "testApp";
+const memberCert0 = "-----BEGIN CERTIFICATE-----\nMIIBvjCCAUSgAwIBAg...0d71ZtULNWo\n-----END CERTIFICATE-----";
+const memberCert1 = "-----BEGIN CERTIFICATE-----\nMIIBwDCCAUagAwIBAgI...2FSyKIC+vY=\n-----END CERTIFICATE-----";
 
-let client: ConfidentialLedgerClient;
-
-export async function main() {
+async function main() {
     console.log("Creating a new instance.")
-    client = new ConfidentialLedgerClient(new DefaultAzureCredential(), subscriptionId);
+    const client = new ConfidentialLedgerClient(new DefaultAzureCredential(), subscriptionId);
 
-    let properties = <ManagedCCFProperties> {
+    const properties = <ManagedCCFProperties> {
         deploymentType: <DeploymentType> {
             appSourceUri: "",
             languageRuntime: KnownLanguageRuntime.JS
         },
         memberIdentityCertificates: [
             <MemberIdentityCertificate>{
-                certificate: "-----BEGIN CERTIFICATE-----\nMIIBvjCCAUSgAwIBAg...0d71ZtULNWo\n-----END CERTIFICATE-----",
+                certificate: memberCert0,
                 encryptionkey: "",
                 tags: { 
                     "owner":"member0"
                 }
             },
             <MemberIdentityCertificate>{
-                certificate: "-----BEGIN CERTIFICATE-----\nMIIBwDCCAUagAwIBAgI...2FSyKIC+vY=\n-----END CERTIFICATE-----",
+                certificate: memberCert1,
                 encryptionkey: "",
                 tags: { 
                     "owner":"member1"
@@ -104,23 +127,23 @@ export async function main() {
         nodeCount: 3,
     };
 
-    let mccf = <ManagedCCF> {
+    const mccf = <ManagedCCF> {
         location: "SouthCentralUS",
         properties: properties,
     }
 
-    let createResponse = await client.managedCCFOperations.beginCreateAndWait(rgName, ledgerId, mccf);
+    const createResponse = await client.managedCCFOperations.beginCreateAndWait(rgName, ledgerId, mccf);
     console.log("Created. Instance id: " +  createResponse.id);
 
     // Get details of the instance
     console.log("Getting instance details.");
-    let getResponse = await client.managedCCFOperations.get(rgName, ledgerId);
+    const getResponse = await client.managedCCFOperations.get(rgName, ledgerId);
     console.log(getResponse.properties?.identityServiceUri);
     console.log(getResponse.properties?.nodeCount);
 
     // List mccf instances in the RG
     console.log("Listing the instances in the resource group.");
-    let instancePages = await client.managedCCFOperations.listByResourceGroup(rgName).byPage();
+    const instancePages = await client.managedCCFOperations.listByResourceGroup(rgName).byPage();
     for await(const page of instancePages){
         for(const instance of page)
         {
@@ -133,11 +156,42 @@ export async function main() {
     console.log("Deleted.");
 }
 
-main().catch((err) => {
-    console.error(err);
-});
+(async () => {
+    try {
+        await main();
+    } catch(err) {
+        console.error(err);
+    }
+})();
 ```
 
+## Delete the Managed CCF resource
+The following piece of code deletes the Managed CCF resource. Other Managed CCF articles can build upon this quickstart. If you plan to continue on to work with subsequent quickstarts and tutorials, you might wish to leave these resources in place.
+
+```TypeScript
+import  { ConfidentialLedgerClient, ManagedCCFProperties, ManagedCCF, KnownLanguageRuntime, DeploymentType, MemberIdentityCertificate } from "@azure/arm-confidentialledger";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const subscriptionId = "0000000-0000-0000-0000-000000000001"; // replace
+const rgName = "myResourceGroup";
+const ledgerId = "confidentialbillingapp";
+
+async function deleteManagedCcfResource() {
+    const client = new ConfidentialLedgerClient(new DefaultAzureCredential(), subscriptionId);
+
+    console.log("Delete the instance.");
+    await client.managedCCFOperations.beginDeleteAndWait(rgName, ledgerId);
+    console.log("Deleted.");
+}
+
+(async () => {
+    try {
+        await deleteManagedCcfResource();
+    } catch(err) {
+        console.error(err);
+    }
+})();
+```
 ## Clean up resources
 
 Other Managed CCF articles can build upon this quickstart. If you plan to continue on to work with subsequent quickstarts and tutorials, you might wish to leave these resources in place.