Add configs needed by each sample to samples-v2.json (#60)

* Add configs needed by each sample to samples-v2.json

* Checkout samples before run prep samples

* Fix `Could not parse expression with acorn` error

'{}' is interpreted as javascript by mdx, so curly brackets needs
escaping, either via '\{' '\}' or put it in code blocks.

https://mdxjs.com/docs/troubleshooting-mdx/#could-not-parse-expression-with-acorn-error

---------

Co-authored-by: Edward J <[email protected]>

.github/workflows/test-deploy.yml

@@ -28,6 +28,13 @@ jobs:
           path: defang
           ref: main
 
+      - name: Checkout DefangLabs/samples
+        uses: actions/checkout@v3
+        with:
+          repository: DefangLabs/samples
+          path: samples
+          ref: main
+
       - name: Set up Go
         uses: actions/setup-go@v2
         with:

docs/tutorials/generate-new-code-using-ai.mdx

@@ -11,7 +11,7 @@ Defang supports generating new project outlines using integration with an AI mod
 
 In this tutorial we'll use the following prompt:
 
-A basic service with 2 REST endpoints. The default endpoint will be for health check and should return a JSON object like this: { "status": "OK" }. The /echo endpoint will echo back all request parameters in the response.
+A basic service with 2 REST endpoints. The default endpoint will be for health check and should return a JSON object like this: `{ "status": "OK" }`. The /echo endpoint will echo back all request parameters in the response.
 
 ## Step 1 - Use the CLI generate command
 ```text

package.json

@@ -31,7 +31,8 @@
     "prism-react-renderer": "^2.1.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "react-markdown": "^9.0.1"
+    "react-markdown": "^9.0.1",
+    "yaml": "^2.4.5"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.0.0",

scripts/prep-samples.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const YAML = require('yaml');
 
 const samplesDir = path.join(__dirname, '..', 'samples', 'samples');
 
@@ -29,7 +30,36 @@ directories.forEach((sample) => {
     const tags = readme.match(/Tags: (.*)/)[1].split(',').map(tag => tag.trim());
     const languages = readme.match(/Languages: (.*)/)[1].split(',').map(language => language.trim());
 
-    jsonArray.push({
+    let configs = [];
+    try {
+        composeFile = fs.readFileSync(path.join(samplesDir, sample, 'compose.yaml'), 'utf8');
+        compose = YAML.parse(composeFile);
+
+        for (var name in compose.services) {
+            service = compose.services[name]
+            if (Array.isArray(service.environment)) {
+                service.environment.forEach(env => {
+                    if (!env.includes("=")) {
+                        configs.push(env);
+                    }
+                });
+            } else {
+                for (var name in service.environment) {
+                    value = service.environment[name];
+                    if (value === null || value === undefined || value === "") {
+                        configs.push(name);
+                    }
+                }
+            }
+        }
+    } catch (error) {
+        // Ignore if the sample doesn't have a compose file
+        if (error.code != 'ENOENT') {
+            console.log(`failed to parese compose for configs for sample`, sample, error);
+        }
+    }
+
+    const sampleSummary = {
         name: directoryName,
         category: languages?.[0],
         readme,
@@ -38,7 +68,12 @@ directories.forEach((sample) => {
         shortDescription,
         tags,
         languages,
-    });
+    };
+    if (configs.length > 0) {
+        sampleSummary.configs = configs;
+    }
+    jsonArray.push(sampleSummary);
+
     console.log(`@@ Added ${sample}`);
 });