Updates to the architecture diagram to reflect knative (#10)

* Update README.md

* updated architecture diagram to reflect knative
This commit is contained in:
seenu433 2023-07-25 18:13:07 -04:00 коммит произвёл GitHub
Родитель 81d0c22641
Коммит 49057b938b
3 изменённых файлов: 58 добавлений и 6 удалений

Просмотреть файл

@ -1,19 +1,21 @@
# CNCF Projects App
## Overview
Have you ever wondered what an application architecture would look like if you committed to using mostly all graduated or incubating projects from the [Cloud Native Computing Foundation](https://www.cncf.io/projects/)? This repo, the **[CNCF](https://www.cncf.io/) Projects App**, attempts to answer that question with an example expense application that is made up almost exclusively of CNCF projects.
## CNCF Projects Application
Have you ever wondered what an application architecture would look like if you committed to using mostly all graduated or incubating projects from the [Cloud Native Computing Foundation](https://www.cncf.io/projects/)? This repo, the **[CNCF](https://www.cncf.io/) Projects App**, attempts to answer that question with an example expense application that is made up almost exclusively of CNCF projects.
## CNCF Projects Application
The CNCF Projects App is a sample expense application simulating a user submitting an expense report. The application consists of the following components:
* [Kubernetes](https://kubernetes.io/) - Container Orchestration Cluster (CNCF)
* [Flux](https://fluxcd.io/). CNCF. GitOps provider for infrastructure delivery (CNCF).
* [Rook](https://rook.io/) - Storage Management (CNCF)
* [Harbor](https://goharbor.io/) - Container Registry (CNCF)
* [NATS](https://nats.io/) - Pub/Sub Messaging (CNCF)
* [Linkerd](https://linkerd.io/) - Service Mesh (CNCF)
* [Prometheus](https://prometheus.io/) - Monitoring (CNCF)
* [Jaeger](https://www.jaegertracing.io/) - Observability/Tracing (CNCF)
* [Knative](https://knative.dev/) - Serverless
* [Knative](https://knative.dev/) - Serverless (CNCF)
* [MySQL](https://www.mysql.com/) - Database
* [Nginx](https://www.nginx.com/) - Kubernetes Ingress Controller
* [Tekton](https://tekton.dev/) CI/CD (CD Foundation)
@ -23,19 +25,67 @@ The CNCF Projects App is a sample expense application simulating a user submitti
* Web Front-End & Web API - [.NET Core](https://docs.microsoft.com/en-us/dotnet/core/about)
## Architecture
Below is the documented CNCF Projects App architecture for reference.
![Alt text](/images/cncf-projects-app-arc.png)
### Workflow
#### Application flow
1. The employee accesses a web app via NGINX Ingress to submit expenses.
2. The web app calls an API app to retrieve the employee's manager.
3. The web app pushes a message that's generated for the creation of the expense report to a Knative broker.
4. The expense report is saved in MySQL.
5. Knative triggers the Email Dispatcher function with the expense message as the payload.
6. Email Dispatcher creates a SendGrid message.
7. SendGrid sends an email to the retrieved manager for review.
#### DevOps flow
a. Developers write or update the code in Visual Studio Code.
b. Developers push the code to GitHub from their local workspace in Visual Studio Code.
c. Github Webhook triggers Tekton pipelines which clones the GitHub code.
d. Pipelines build and push and the container images to a Harbor registry.
e. Tekton deploys the web app, API app, and Email Dispatcher applications.
f. Prometheus captures application metrics.
g. Engineers monitor metrics on a Grafana Dashboard.
h. DevOps engineers monitor the Grafana Dashboard.
#### Infrastructure
i. AKS cluster based on the infrastructure presented in the AKS baseline.
ii. Rook Ceph used for cluster storage.
iii. Linkerd service mesh.
iv. Jaeger for overall application tracing on the Kubernetes cluster.
## Install
Please follow the instructions [here](notes.md) in sequence to deploy the CNCF Projects App in your environment.
Instructions for automated deployment through gitops are [here](/gitops/readme.md).
## Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Двоичные данные
images/cncf-projects-app-arc.png

Двоичный файл не отображается.

До

Ширина:  |  Высота:  |  Размер: 397 KiB

После

Ширина:  |  Высота:  |  Размер: 171 KiB

Просмотреть файл

@ -17,4 +17,6 @@ TODO: Explain how other users and developers can contribute to make your code be
If you want to learn more about creating good readme files then refer the following [guidelines](https://docs.microsoft.com/en-us/azure/devops/repos/git/create-a-readme?view=azure-devops). You can also seek inspiration from the below readme files:
- [ASP.NET Core](https://github.com/aspnet/Home)
- [Visual Studio Code](https://github.com/Microsoft/vscode)
- [Chakra Core](https://github.com/Microsoft/ChakraCore)
- [Chakra Core](https://github.com/Microsoft/ChakraCore)
# Testing Update 1