You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs-source/cloudbank/content/_index.md
+23-48Lines changed: 23 additions & 48 deletions
Original file line number
Diff line number
Diff line change
@@ -3,17 +3,14 @@ archetype = "home"
3
3
title = "CloudBank AI"
4
4
+++
5
5
6
-
Welcome to CloudBank AI - an on-demand, self-paced learning resource you can use
7
-
to learn about developing microservices with [Spring Boot](https://spring.io/projects/spring-boot)
8
-
and [Spring Cloud Oracle](https://github.com/oracle/spring-cloud-oracle)
9
-
and deploying, running and managing them with [Oracle Backend for Spring Boot and Microservices](https://bit.ly/oraclespringboot).
6
+
Welcome to CloudBank AI - an on-demand, self-paced learning resource you can use to learn about developing microservices with [Spring Boot](https://spring.io/projects/spring-boot)
7
+
and [Spring Cloud Oracle](https://github.com/oracle/spring-cloud-oracle) and deploying, running and managing them with [Oracle Backend for Microservices and AI](https://bit.ly/OracleAI-microservices).
10
8
11
9
You can follow through from beginning to end, or you can start at any module that you are interested in.
12
10
13
11
### What you will need
14
12
15
-
To complete the modules you will somewhere to run Oracle Backend for Spring Boot and Microservices.
16
-
The instructions in the Module 1 provide three alternatives:
13
+
To complete the modules you will somewhere to run Oracle Backend for Microservices and AI. The instructions in the Module 1 provide three alternatives:
17
14
18
15
- Locally in a container - you will need a container platform like Docker Desktop, Rancher Desktop, Podman Desktop or similar.
19
16
This option is recommended only if you have at least 64GB of RAM. With less memory this option will probably be too slow.
@@ -32,45 +29,23 @@ but you will have a better overall experience if you use one. We recommend Visu
32
29
33
30
CloudBank contains the following modules:
34
31
35
-
***Module 1: Provision the Backend**
36
-
This module guides you through provisioning an instance of the backend using
37
-
Oracle Cloud Infrastructure (OCI) or on your local machine using Docker Compose.
38
-
***Module 2: Preparing your Development Environment**
39
-
This module guides you through setting up your development environment including
40
-
and IDE and a toolchain to build and test your applications.
41
-
***Module 3: Build the Account Microservice**
42
-
This module walks you through building your very first microservice using Spring Boot.
43
-
It assumes no prior knowledge of Spring Boot, so its a great place to start if you
44
-
have not used Spring Boot before. This module demonstrates how to build a service
45
-
with a *synchronous* API implemented as REST endpoints using Spring Web MVC, and how to
46
-
store data in Oracle Database using Spring Data JPA.
47
-
***Module 4: Build the Check Processing Microservices**
48
-
In this module, you will build microservices that use *asynchronous* messaging
49
-
to communicate using Spring JMS and Oracle Transactional Event Queues. It introduces
50
-
service discovery using Eureka Service Registry (part of [Spring Cloud Netflix](https://spring.io/projects/spring-cloud-netflix))
51
-
and [Spring Cloud OpenFeign](https://spring.io/projects/spring-cloud-openfeign).
52
-
***Module 5: Manage Saga Transactions across Microservices**
53
-
This module introduces the Saga pattern, a very important pattern that helps us
54
-
manage data consistency across microservices. We will explore the Long Running
55
-
Action specification, one implementation of the Saga pattern, and then build
56
-
a Transfer microservice that will manage funds transfers using a saga.
57
-
***Module 6: Building the CloudBank AI Assistant using Spring AI**
58
-
This modules introduces [Spring AI](https://github.com/spring-projects/spring-ai)
59
-
and explores how it can be used to build a CloudBank AI Assistant (chatbot) that will
60
-
allow users to interact with CloudBank using a chat-based interface.
61
-
***Module 7: Deploying the full CloudBank Application using the CLI**
62
-
In this module, you will learn how to deploy the full CloudBank application
63
-
to Oracle Backend for Spring Boot and Microservices using the CLI.
64
-
If you prefer to use an IDE, skip this module and go to module 6 instead.
65
-
***Module 8: Deploying the full CloudBank Application using the IDE plugins**
66
-
In this module, you will learn how to deploy the full CloudBank application
67
-
to Oracle Backend for Spring Boot and Microservices using one of the
68
-
IDE plugins - for Visual Studio Code or IntelliJ.
69
-
***Module 9: Explore the Backend Platform**
70
-
This module will take you on a guided tour through the Oracle Backend for
71
-
Spring Boot and Microservices platform. You will learn about the platform
72
-
services and observability tools that are provided out-of-the-box.
73
-
***Module 10: Cleanup**
74
-
This module demonstrates how to clean up any resources created when
75
-
you provisioned an instance of Oracle Backend for Spring Boot and Microservices
76
-
on Oracle Cloud Infrastructure (OCI) or on your local machine using Docker Compose.
32
+
-**Module 1: Provision the Backend**
33
+
This module guides you through provisioning an instance of the backend using Oracle Cloud Infrastructure (OCI) or on your local machine using Docker Compose.
34
+
-**Module 2: Preparing your Development Environment**
35
+
This module guides you through setting up your development environment including and IDE and a toolchain to build and test your applications.
36
+
-**Module 3: Build the Account Microservice**
37
+
This module walks you through building your very first microservice using Spring Boot. It assumes no prior knowledge of Spring Boot, so its a great place to start if you have not used Spring Boot before. This module demonstrates how to build a service with a *synchronous* API implemented as REST endpoints using Spring Web MVC, and how to store data in Oracle Database using Spring Data JPA.
38
+
-**Module 4: Build the Check Processing Microservices**
39
+
In this module, you will build microservices that use *asynchronous* messaging to communicate using Spring JMS and Oracle Transactional Event Queues. It introduces service discovery using Eureka Service Registry (part of [Spring Cloud Netflix](https://spring.io/projects/spring-cloud-netflix)) and [Spring Cloud OpenFeign](https://spring.io/projects/spring-cloud-openfeign).
40
+
-**Module 5: Manage Saga Transactions across Microservices**
41
+
This module introduces the Saga pattern, a very important pattern that helps us manage data consistency across microservices. We will explore the Long Running Action specification, one implementation of the Saga pattern, and then build a Transfer microservice that will manage funds transfers using a saga.
42
+
-**Module 6: Building the CloudBank AI Assistant using Spring AI**
43
+
This modules introduces [Spring AI](https://github.com/spring-projects/spring-ai) and explores how it can be used to build a CloudBank AI Assistant (chatbot) that will allow users to interact with CloudBank using a chat-based interface.
44
+
-**Module 7: Deploying the full CloudBank Application using the CLI**
45
+
In this module, you will learn how to deploy the full CloudBank application to Oracle Backend for Microservices and AI using the CLI. If you prefer to use an IDE, skip this module and go to module 6 instead.
46
+
-**Module 8: Deploying the full CloudBank Application using the IDE plugins**
47
+
In this module, you will learn how to deploy the full CloudBank application to Oracle Backend for Microservices and AI using one of the IDE plugins - for Visual Studio Code or IntelliJ.
48
+
-**Module 9: Explore the Backend Platform**
49
+
This module will take you on a guided tour through the Oracle Backend for Microservices and AI platform. You will learn about the platform services and observability tools that are provided out-of-the-box.
50
+
-**Module 10: Cleanup**
51
+
This module demonstrates how to clean up any resources created when you provisioned an instance of Oracle Backend for Microservices and AI on Oracle Cloud Infrastructure (OCI) or on your local machine using Docker Compose.
Copy file name to clipboardExpand all lines: docs-source/cloudbank/content/account/_index.md
+1-5Lines changed: 1 addition & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -4,8 +4,4 @@ title = "Account Microservice"
4
4
weight = 3
5
5
+++
6
6
7
-
This module walks you through building your very first microservice using Spring Boot.
8
-
It assumes no prior knowledge of Spring Boot, so its a great place to start if you
9
-
have not used Spring Boot before. This module demonstrates how to build a service
10
-
with a *synchronous* API implemented as REST endpoints using Spring Web MVC, and how to
11
-
store data in Oracle Database using Spring Data JPA.
7
+
This module walks you through building your very first microservice using Spring Boot. It assumes no prior knowledge of Spring Boot, so its a great place to start if you have not used Spring Boot before. This module demonstrates how to build a service with a *synchronous* API implemented as REST endpoints using Spring Web MVC, and how to store data in Oracle Database using Spring Data JPA.
Copy file name to clipboardExpand all lines: docs-source/cloudbank/content/account/deploy.md
+9-9Lines changed: 9 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ weight = 9
7
7
8
8
1. Prepare the data source configuration for deployment
9
9
10
-
Update the data source configuration in your `src/main/resources/application.yaml` as shown in the example below. This will cause the service to read the correct database details that will be injected into its pod by the Oracle Backend for Spring Boot and Microservices.
10
+
Update the data source configuration in your `src/main/resources/application.yaml` as shown in the example below. This will cause the service to read the correct database details that will be injected into its pod by the Oracle Backend for Microservices and AI.
11
11
12
12
```yaml
13
13
datasource:
@@ -100,21 +100,21 @@ weight = 9
100
100
101
101
1. Prepare the backend for deployment
102
102
103
-
The Oracle Backend for Spring Boot and Microservices admin service is not exposed outside the Kubernetes cluster by default. Oracle recommends using a **kubectl** port forwarding tunnel to establish a secure connection to the admin service.
103
+
The Oracle Backend for Microservices and AI admin service is not exposed outside the Kubernetes cluster by default. Oracle recommends using a **kubectl** port forwarding tunnel to establish a secure connection to the admin service.
104
104
105
105
Start a tunnel using this command in a new terminal window:
Get the password for the `obaas-admin` user. The `obaas-admin` user is the equivalent of the admin or root user in the Oracle Backend for Spring Boot and Microservices backend.
111
+
Get the password for the `obaas-admin` user. The `obaas-admin` user is the equivalent of the admin or root user in the Oracle Backend for Microservices and AI backend.
Start the Oracle Backend for Spring Boot and Microservices CLI (*oractl*) in a new terminal window using this command:
117
+
Start the Oracle Backend for Microservices and AI CLI (*oractl*) in a new terminal window using this command:
118
118
119
119
```shell
120
120
$ oractl
@@ -133,7 +133,7 @@ weight = 9
133
133
oractl:>
134
134
```
135
135
136
-
Connect to the Oracle Backend for Spring Boot and Microservices admin service using the `connect` command. Enter `obaas-admin` and the username and use the password you collected earlier.
136
+
Connect to the Oracle Backend for Microservices and AI admin service using the `connect` command. Enter `obaas-admin` and the username and use the password you collected earlier.
137
137
138
138
```shell
139
139
oractl> connect
@@ -143,7 +143,7 @@ weight = 9
143
143
oractl:>
144
144
```
145
145
146
-
Create a database "binding" by tunning this command. Enter the password (`Welcome1234##`) when prompted. This will create a Kubernetes secret in the `application` namespace called `account-db-secrets` which contains the username (`account`), password, and URL to connect to the Oracle Autonomous Database instance associated with the Oracle Backend for Spring Boot and Microservices.
146
+
Create a database "binding" by tunning this command. Enter the password (`Welcome1234##`) when prompted. This will create a Kubernetes secret in the `application` namespace called `account-db-secrets` which contains the username (`account`), password, and URL to connect to the Oracle Autonomous Database instance associated with the Oracle Backend for Microservices and AI.
You will now deploy your account service to the Oracle Backend for Spring Boot and Microservices using the CLI. You will deploy into the `application` namespace, and the service name will be `account`. Run this command to deploy your service, make sure you provide the correct path to your JAR file. **Note** that this command may take 1-3 minutes to complete:
159
+
You will now deploy your account service to the Oracle Backend for Microservices and AI using the CLI. You will deploy into the `application` namespace, and the service name will be `account`. Run this command to deploy your service, make sure you provide the correct path to your JAR file. **Note** that this command may take 1-3 minutes to complete:
> What happens when you use the Oracle Backend for Spring Boot and Microservices CLI (*oractl*) **deploy** command? When you run the **deploy** command, the Oracle Backend for Spring Boot and Microservices CLI does several things for you:
172
+
> What happens when you use the Oracle Backend for Microservices and AI CLI (*oractl*) **deploy** command? When you run the **deploy** command, the Oracle Backend for Microservices and AI CLI does several things for you:
173
173
174
174
* Uploads the JAR file to server side
175
175
* Builds a container image and push it to the OCI Registry
Copy file name to clipboardExpand all lines: docs-source/cloudbank/content/account/expose.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -91,5 +91,5 @@ Now that the account service is deployed, you need to expose it through the API
91
91
}
92
92
```
93
93
94
-
Your service is deployed in the Oracle Backend forSpring Boot and Microservices environment and using the Oracle Autonomous Database instance associated with the backend.
94
+
Your service is deployed in the Oracle Backend forMicroservices and AI environment and using the Oracle Autonomous Database instance associated with the backend.
Copy file name to clipboardExpand all lines: docs-source/cloudbank/content/backend/admin.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -5,11 +5,11 @@ weight = 4
5
5
+++
6
6
7
7
8
-
Oracle Backend for Spring Boot and Microservices includes Spring Admin which provides a web user interface for managing and monitoring Spring applications.
8
+
Oracle Backend for Microservices and AI includes Spring Admin which provides a web user interface for managing and monitoring Spring applications.
9
9
10
10
1. Connect to Spring Admin
11
11
12
-
Oracle Backend for Spring Boot and Microservices does not expose management interfaces outside the Kubernetes cluster for improved security. Oracle recommends you access these interfaces using **kubectl** port forwarding, which creates an encrypted tunnel from your client machine to the cluster to access a specific service in the cluster.
12
+
Oracle Backend for Microservices and AI does not expose management interfaces outside the Kubernetes cluster for improved security. Oracle recommends you access these interfaces using **kubectl** port forwarding, which creates an encrypted tunnel from your client machine to the cluster to access a specific service in the cluster.
13
13
14
14
Open a tunnel to the Spring Admin server using this command:
Copy file name to clipboardExpand all lines: docs-source/cloudbank/content/backend/apisix.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ title = "Explore APISIX API Gateway"
4
4
weight = 6
5
5
+++
6
6
7
-
Oracle Backend for Spring Boot and Microservices includes APISIX API Gateway to manage which services are made available outside the Kubernetes cluster. APISIX allows you to manage many aspects of the services' APIs including authentication, logging, which HTTP methods are accepted, what URL paths are exposed, and also includes capabilities like rewriting, filtering, traffic management and has a rich plugin ecosystem to enhance it with additional capabilities. You can manage the APISIX API Gateway using the APISIX Dashboard.
7
+
Oracle Backend for Microservices and AI includes APISIX API Gateway to manage which services are made available outside the Kubernetes cluster. APISIX allows you to manage many aspects of the services' APIs including authentication, logging, which HTTP methods are accepted, what URL paths are exposed, and also includes capabilities like rewriting, filtering, traffic management and has a rich plugin ecosystem to enhance it with additional capabilities. You can manage the APISIX API Gateway using the APISIX Dashboard.
0 commit comments