Skip to content

Commit 1166565

Browse files
authored
Naming and version updates (#956)
1 parent c2d8877 commit 1166565

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+141
-193
lines changed

cloudbank-v4/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
<parent>
99
<groupId>org.springframework.boot</groupId>
1010
<artifactId>spring-boot-starter-parent</artifactId>
11-
<version>3.3.3</version>
11+
<version>3.3.4</version>
1212
<relativePath/> <!-- lookup parent from repository -->
1313
</parent>
1414

docs-source/cloudbank/content/_index.md

Lines changed: 23 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,14 @@ archetype = "home"
33
title = "CloudBank AI"
44
+++
55

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).
108

119
You can follow through from beginning to end, or you can start at any module that you are interested in.
1210

1311
### What you will need
1412

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:
1714

1815
- Locally in a container - you will need a container platform like Docker Desktop, Rancher Desktop, Podman Desktop or similar.
1916
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
3229

3330
CloudBank contains the following modules:
3431

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.

docs-source/cloudbank/content/account/_index.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,4 @@ title = "Account Microservice"
44
weight = 3
55
+++
66

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.

docs-source/cloudbank/content/account/create-project.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Create a project to hold your Account service. In this lab, you will use the Sp
1414

1515
1. Select the Spring Boot Version
1616

17-
You will be presented with a list of available Spring Boot versions. Choose **3.2.2** (or the latest 3.2.x version available).
17+
You will be presented with a list of available Spring Boot versions. Choose **3.3.4** (or the latest 3.3.x version available).
1818

1919
![Specify Spring Boot version](../images/obaas-spring-init-2.png " ")
2020

docs-source/cloudbank/content/account/deploy.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ weight = 9
77

88
1. Prepare the data source configuration for deployment
99

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.
1111

1212
```yaml
1313
datasource:
@@ -100,21 +100,21 @@ weight = 9
100100

101101
1. Prepare the backend for deployment
102102

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.
104104

105105
Start a tunnel using this command in a new terminal window:
106106

107107
```shell
108108
$ kubectl -n obaas-admin port-forward svc/obaas-admin 8080
109109
```
110110

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 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.
112112

113113
```shell
114114
$ kubectl get secret -n azn-server oractl-passwords -o jsonpath='{.data.admin}' | base64 -d
115115
```
116116

117-
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:
118118

119119
```shell
120120
$ oractl
@@ -133,7 +133,7 @@ weight = 9
133133
oractl:>
134134
```
135135

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.
137137

138138
```shell
139139
oractl> connect
@@ -143,7 +143,7 @@ weight = 9
143143
oractl:>
144144
```
145145

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.
147147

148148
```shell
149149
oractl:> bind --app-name application --service-name account
@@ -156,10 +156,10 @@ weight = 9
156156

157157
1. Deploy the account service
158158

159-
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:
160160

161161
```shell
162-
oractl:> deploy --app-name application --service-name account --artifact-path /path/to/accounts-0.0.1-SNAPSHOT.jar --image-version 0.0.1
162+
oractl:> deploy --app-name application --service-name account --artifact-path /path/to/accounts-0.0.1-SNAPSHOT.jar --image-version 0.0.1 --java-version ghcr.io/oracle/graalvm-native-image-obaas:21
163163
uploading: /Users/atael/tmp/cloudbank/accounts/target/accounts-0.0.1-SNAPSHOT.jar
164164
building and pushing image...
165165
@@ -169,7 +169,7 @@ weight = 9
169169
oractl:>
170170
```
171171

172-
> 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:
173173

174174
* Uploads the JAR file to server side
175175
* Builds a container image and push it to the OCI Registry

docs-source/cloudbank/content/account/expose.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,5 +91,5 @@ Now that the account service is deployed, you need to expose it through the API
9191
}
9292
```
9393
94-
Your service is deployed in the Oracle Backend for Spring Boot and Microservices environment and using the Oracle Autonomous Database instance associated with the backend.
94+
Your service is deployed in the Oracle Backend for Microservices and AI environment and using the Oracle Autonomous Database instance associated with the backend.
9595
Loading

docs-source/cloudbank/content/account/intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ In this lab, you will:
2020
* Prepare objects in the Oracle Database using SQLcl
2121
* Use Spring Data JPA to allow your microservice to use the data in the Oracle database
2222
* Create REST services to allow clients to perform create, read, update, and delete operations on accounts
23-
* Deploy your microservice into the backend (Oracle Backend for Spring Boot and Microservices)
23+
* Deploy your microservice into the backend (Oracle Backend for Microservices and AI)
2424

2525
### Prerequisites (Optional)
2626

docs-source/cloudbank/content/backend/admin.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ weight = 4
55
+++
66

77

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.
99

1010
1. Connect to Spring Admin
1111

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.
1313

1414
Open a tunnel to the Spring Admin server using this command:
1515

docs-source/cloudbank/content/backend/apisix.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title = "Explore APISIX API Gateway"
44
weight = 6
55
+++
66

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.
88

99
1. Access the APISIX Dashboard
1010

0 commit comments

Comments
 (0)