Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 2,204 Commits
.github		.github
.mvn/wrapper		.mvn/wrapper
docs		docs
extras		extras
iac		iac
kubernetes-manifests		kubernetes-manifests
src		src
.gitignore		.gitignore
.pylintrc		.pylintrc
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
mvnw		mvnw
mvnw.cmd		mvnw.cmd
pom.xml		pom.xml
skaffold-e2e.yaml		skaffold-e2e.yaml
skaffold.yaml		skaffold.yaml

Repository files navigation

Bank of Anthos

Bank of Anthos is a sample HTTP-based web app that simulates a bank's payment processing network, allowing users to create artificial bank accounts and complete transactions.

Google uses this application to demonstrate how developers can modernize enterprise applications using Google Cloud products, including:Google Kubernetes Engine (GKE),Anthos Service Mesh (ASM),Anthos Config Management (ACM),Migrate to Containers,Spring Cloud GCP,Cloud Operations,Cloud SQL,Cloud Build, andCloud Deploy. This application works on any Kubernetes cluster.

If you are using Bank of Anthos, please ★Star this repository to show your interest!

Note to Googlers: Please fill out the form atgo/bank-of-anthos-form.

Screenshots

Sign in	Home

Service architecture

Service	Language	Description
frontend	Python	Exposes an HTTP server to serve the website. Contains login page, signup page, and home page.
ledger-writer	Java	Accepts and validates incoming transactions before writing them to the ledger.
balance-reader	Java	Provides efficient readable cache of user balances, as read from`ledger-db`.
transaction-history	Java	Provides efficient readable cache of past transactions, as read from`ledger-db`.
ledger-db	PostgreSQL	Ledger of all transactions. Option to pre-populate with transactions for demo users.
user-service	Python	Manages user accounts and authentication. Signs JWTs used for authentication by other services.
contacts	Python	Stores list of other accounts associated with a user. Used for drop down in "Send Payment" and "Deposit" forms.
accounts-db	PostgreSQL	Database for user accounts and associated data. Option to pre-populate with demo users.
loadgenerator	Python/Locust	Continuously sends requests imitating users to the frontend. Periodically creates new accounts and simulates transactions between them.

Interactive quickstart (GKE)

The following button opens up an interactive tutorial showing how to deploy Bank of Anthos in GKE:

Quickstart (GKE)

Ensure you have the following requirements:
- Google Cloud project.
- Shell environment withgcloud,git, andkubectl.

Clone the repository.

git clone https://github.com/GoogleCloudPlatform/bank-of-anthoscd bank-of-anthos/

Set the Google Cloud project and region and ensure the Google Kubernetes Engine API is enabled.
```
export PROJECT_ID=<PROJECT_ID>export REGION=us-central1gcloud servicesenable container.googleapis.com \  --project=${PROJECT_ID}
```
Substitute<PROJECT_ID> with the ID of your Google Cloud project.

Create a GKE cluster and get the credentials for it.

gcloud container clusters create-auto bank-of-anthos \  --project=${PROJECT_ID} --region=${REGION}

Creating the cluster may take a few minutes.

Deploy Bank of Anthos to the cluster.

kubectl apply -f ./extras/jwt/jwt-secret.yamlkubectl apply -f ./kubernetes-manifests

Wait for the pods to be ready.

kubectl get pods

After a few minutes, you should see the Pods in aRunning state:

NAME                                  READY   STATUS    RESTARTS   AGEaccounts-db-6f589464bc-6r7b7          1/1     Running   0          99sbalancereader-797bf6d7c5-8xvp6        1/1     Running   0          99scontacts-769c4fb556-25pg2             1/1     Running   0          98sfrontend-7c96b54f6b-zkdbz             1/1     Running   0          98sledger-db-5b78474d4f-p6xcb            1/1     Running   0          98sledgerwriter-84bf44b95d-65mqf         1/1     Running   0          97sloadgenerator-559667b6ff-4zsvb        1/1     Running   0          97stransactionhistory-5569754896-z94cn   1/1     Running   0          97suserservice-78dc876bff-pdhtl          1/1     Running   0          96s

Access the web frontend in a browser using the frontend's external IP.
```
kubectl get service frontend| awk'{print $4}'
```
Visithttp://EXTERNAL_IP in a web browser to access your instance of Bank of Anthos.

Once you are done with it, delete the GKE cluster.

gcloud container clusters delete bank-of-anthos \  --project=${PROJECT_ID} --region=${REGION}

Deleting the cluster may take a few minutes.

Additional deployment options

Workload Identity:See these instructions.
Cloud SQL:See these instructions to replace the in-cluster databases with hosted Google Cloud SQL.
Multi Cluster with Cloud SQL:See these instructions to replicate the app across two regions using GKE, Multi Cluster Ingress, and Google Cloud SQL.
Istio:See these instructions to configure an IngressGateway.
Anthos Service Mesh: ASM requires Workload Identity to be enabled in your GKE cluster.See the workload identity instructions to configure and deploy the app. Then, applyextras/istio/ to your cluster to configure frontend ingress.
Java Monolith (VM): We provide a version of this app where the three Java microservices are coupled together into one monolithic service, which you can deploy inside a VM (eg. Google Compute Engine). See theledgermonolith directory.