Merge pull request #603 from MetaCell/release/2.0.0

Release/2.0.0

Author: filippomc

.dockerignore

@@ -1,10 +1,12 @@
 **/node_modules
 .tox
 docs
-applications
-infrastructure
-blueprint
+/applications
+/infrastructure
+/blueprint
 test
 .github
 .git
-.vscode
+.vscode
+/deployment
+skaffold.yaml

.gitignore

@@ -6,11 +6,14 @@ node_modules
 .vscode
 .coverage
 *.DS_Store
-deployment
+deployment/helm
 *.egg-info
 *.idea
 /build
 skaffold.yaml
 .tox
 .pytest_cache
-.overrides
+.overrides
+deployment.yaml
+.hypothesis
+__pycache__

README.md

@@ -17,7 +17,6 @@ What building your cloud solution with CloudHarness gives to you:
     - access gatekeepers configuration
     - secrets
     - templated config maps from files
-    - secrets
   * Automatic build and push of images
   * REST-API scaffolding building based on OpenApi
   * Continuous deployment script generation
@@ -28,7 +27,12 @@ What building your cloud solution with CloudHarness gives to you:
   * Submit batch and asynchronous workflows - based on Argo
   * Orchestrate microservices - based on Kafka
   * Assign compute workspaces to users - based Jupyterhub
-  
+* Testing framework to help you write and run tests
+  * Unit tests
+  * API integration tests
+  * End to End tests (with Puppeteer)
+* CI/CD pipelines generation
+
 # Why CloudHarness?
 
 The microservice architecture is a great to get code separation and flexible development, but may not be of easy implementation, especially for small development teams/projects.
@@ -52,7 +56,7 @@ CloudHarness provides the following command line tools to help application scaff
 * `harness-deployment` - generate the helm chart to deploy on Kubernetes. 
 * `harness-application` - create a new CloudHarness REST application.
 * `harness-generate` - generates server and client code for all CloudHarness REST applications.
-
+* `harness-test` - run end to end tests
 # Get started
 
 ## Prerequisites
@@ -66,14 +70,14 @@ Cloudharness can be used on all major operative systems.
 - Windows native: mostly working, unsupported  
 
 ### Python
-Python 3.7-3.9 must be installed.
+Python 3.9 must be installed.
 
 It is recommended to setup a virtual environment.
 With conda: 
- ```bash
- conda create --name ch python=3.7
- conda activate ch
- ```
+```bash
+conda create --name ch python=3.9
+conda activate ch
+```
 
 ### Docker
 [Docker](https://www.docker.com) is required to build locally.
@@ -90,11 +94,26 @@ With conda:
 
 [Skaffold](https://skaffold.dev/docs/install/) is the way to go to build and debug your application in your local development environment.
 
+### Node environment
+
+A node environment with npm is required for developing web applications and to run end to end tests.
+
+Recommended:
+- node >= v14.0.0
+- npm >= 8.0.0
+
+### Java Runtime Environment
+
+A JRE is needed to run the code generators based on openapi-generator.
+
+For more info, see [here](https://openapi-generator.tech/docs/installation).
+
+
 ## CloudHarness command line tools
 To use the cli tools, install requirements first:
 
 ```bash
-source install.sh
+bash install.sh
 ```
 ### Generate deployment
 
@@ -141,7 +160,7 @@ harness-deployment cloud-harness . [PARAMS]
 ```
 
 to create the build and deployment artifacts for your solution.
-See the dedicated [Build and deploy](./docs/build-deploy-howto.md) document for more details and examples.
+See the dedicated [Build and deploy](./docs/build-deploy/README.md) document for more details and examples.
 
 # Add and manage applications
 

…tilities/application-templates/README.md application-templates/README.mdtools/cloudharness_utilities/application-templates/README.md renamed to application-templates/README.md tools/cloudharness_utilities/application-templates/README.md renamed to application-templates/README.md

@@ -0,0 +1,6 @@
+harness:
+    users:
+    - username: __APP_NAME__
+      email: __APP_NAME__@testuser.com
+      clientRoles: []
+      realmRoles: []

…plication-templates/base/api/config.json …plication-templates/base/api/config.jsontools/cloudharness_utilities/application-templates/base/api/config.json renamed to application-templates/base/api/config.json tools/cloudharness_utilities/application-templates/base/api/config.json renamed to application-templates/base/api/config.json

@@ -14,4 +14,10 @@ harness:
   dependencies:
     build:
       - cloudharness-base
-      - cloudharness-flask
+      - cloudharness-flask
+  test:
+    api:
+      enabled: true
+      autotest: true
+      checks:
+        - all

…lication-templates/base/api/openapi.yaml …lication-templates/base/api/openapi.yamltools/cloudharness_utilities/application-templates/base/api/openapi.yaml renamed to application-templates/base/api/openapi.yaml tools/cloudharness_utilities/application-templates/base/api/openapi.yaml renamed to application-templates/base/api/openapi.yaml

@@ -0,0 +1,18 @@
+import os
+from pprint import pprint
+import schemathesis as st
+from schemathesis.checks import response_schema_conformance, not_a_server_error
+
+from cloudharness_test import apitest_init # include to perform default authorization
+
+app_url = os.environ.get("APP_URL", "http://samples.ch.local/api")
+
+schema = st.from_uri(app_url + "/openapi.json")
+
+
+@schema.parametrize(endpoint="/ping")
+def test_ping(case):
+    response = case.call()
+    pprint(response.__dict__)
+    assert response.status_code == 200, "this api errors on purpose"
+

application-templates/base/deploy/values-test.yaml

@@ -0,0 +1,35 @@
+import * as puppeteer from "puppeteer";
+
+let page: any;
+let browser: any;
+
+describe("End to end test", () => {
+  beforeAll(async () => {
+    browser = await puppeteer.launch({args: ['--no-sandbox'],});
+    page = await browser.newPage();
+    console.log(process.env.APP_URL)
+    await page
+      .goto(process.env.APP_URL, {
+        waitUntil: "networkidle0",
+      })
+      // tslint:disable-next-line:no-empty
+      .catch(() => {});
+  });
+
+  afterAll(() => {
+    if (!page.isClosed()) {
+      browser.close();
+    }
+  });
+
+  // TODO CHANGEME
+  test("should see the landing page", async () => {
+    await page.waitForSelector("h1");
+    const title = await page.$eval("h1", (el: { textContent: any }) => {
+      return el.textContent;
+    });
+
+    expect(await page.title()).toEqual("Samples");
+    expect(title).toEqual("Sample React application is working!");
+  });
+});