Skip to content

Commit bfdc54c

Browse files
authored
Change shortening of TEQ to TxEventQ (#481)
* wip : fix txeventq name * change package name to txeventq * option ADB_FREE * fix setup kafka 2 txeventq script name * add script for remove compartment from lab
1 parent baa4cac commit bfdc54c

File tree

114 files changed

+342
-322
lines changed

Some content is hidden

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

114 files changed

+342
-322
lines changed

workshops/oracleteq-kafka/cloud-setup/cmd/teq-add-topic

Lines changed: 0 additions & 75 deletions
This file was deleted.

workshops/oracleteq-kafka/springboot-oracleteq/teq-ms-deploy-consumer

Lines changed: 0 additions & 37 deletions
This file was deleted.

workshops/oracleteq-kafka/springboot-oracleteq/teq-ms-deploy-producer

Lines changed: 0 additions & 36 deletions
This file was deleted.

workshops/oracleteq-kafka/README.md renamed to workshops/txeventq-kafka/README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11

2-
# Simplify Event-driven Apps with TEQ in Oracle Database (with Kafka interoperability) Workshop
2+
# Simplify Event-driven Apps with TxEventQ in Oracle Database (with Kafka interoperability) Workshop
33

44
## Introduction
55

66
### About this Workshop
77

88
This repository contains sample code from the workshop to help you understand Event Mesh using two message brokers and the technical capabilities inside the converged [Oracle Autonomous Database][ATP] to support a scalable event-driven microservices architecture.
99

10-
You will create four event-driven microservice and two messaging brokers to allow communication between them. In the first lab, you will deploy an Apache Kafka broker to leverage the event-driven communication between two microservices written in Spring Boot. In the second lab, you will create an Oracle Transactional Event Queues (TEQ) and experience the Kafka APIs working in the Kafka compatibility mode. Likewise, this module has the Spring Boot producer and consumer microservices but with Kafka Java client for TEQ, using the okafka library. And finally, in the third lab, you will experiment with the concept of Event Mesh, building a bridge between Kafka and TEQ brokers, and see messages being produced on the Kafka side and consumed on the TEQ side.
10+
You will create four event-driven microservice and two messaging brokers to allow communication between them. In the first lab, you will deploy an Apache Kafka broker to leverage the event-driven communication between two microservices written in Spring Boot. In the second lab, you will create an Oracle Transactional Event Queues (TxEventQ) and experience the Kafka APIs working in the Kafka compatibility mode. Likewise, this module has the Spring Boot producer and consumer microservices but with Kafka Java client for TxEventQ, using the okafka library. And finally, in the third lab, you will experiment with the concept of Event Mesh, building a bridge between Kafka and TxEventQ brokers, and see messages being produced on the Kafka side and consumed on the TxEventQ side.
1111

1212
Estimated Workshop Time: 50 minutes
1313

14-
> This workshop is part of the [Oracle LiveLabs][LiveLabs] and you can access it through the following address [TEQ in Oracle Database][TEQinOracleDatabase]
14+
> This workshop is part of the [Oracle LiveLabs][LiveLabs] and you can access it through the following address [TxEventQ in Oracle Database][TxEventQinOracleDatabase]
1515
1616
### About Product/Technology
1717

18-
* [Oracle Transactional Event Queues][TEQ] is a powerful messaging backbone offered by converged Oracle Database that allows you to build an enterprise-class data-centric microservices architecture.
18+
* [Oracle Transactional Event Queues][TxEventQ] is a powerful messaging backbone offered by converged Oracle Database that allows you to build an enterprise-class data-centric microservices architecture.
1919

2020
* [Kafka][kafka] is an open-source distributed event streaming platform used for high-performance data pipelines, streaming analytics, data integration, and mission-critical applications.
2121

@@ -27,9 +27,9 @@ Estimated Workshop Time: 50 minutes
2727

2828
* The first Lab reviews the Kafka and Spring Boot Microservice built to produce and consume messages.
2929

30-
* The second Lab will use Oracle Transactional Event Queues (TEQ) and okafka library and demonstrate the Kafka compatibility of TEQ. Also, this module has the same Spring Boot producer and consumer microservices but uses okafka in place of Kafka libraries and TEQ in the database in place of Kafka broker.
30+
* The second Lab will use Oracle Transactional Event Queues (TxEventQ) and okafka library and demonstrate the Kafka compatibility of TxEventQ. Also, this module has the same Spring Boot producer and consumer microservices but uses okafka in place of Kafka libraries and TxEventQ in the database in place of Kafka broker.
3131

32-
* The third Lab will interconnect the Kafka broker and the Oracle Transactional Event Queues (TEQ), applying Kafka connector and Oracle Database Messaging libraries. This laboratory demonstrates the interoperability between the two brokers, with events flowing from the Kafka side to TEQ, finally consumed at the TEQ side.
32+
* The third Lab will interconnect the Kafka broker and the Oracle Transactional Event Queues (TxEventQ), applying Kafka connector and Oracle Database Messaging libraries. This laboratory demonstrates the interoperability between the two brokers, with events flowing from the Kafka side to TxEventQ, finally consumed at the TxEventQ side.
3333

3434
## Prerequisites
3535

@@ -44,18 +44,18 @@ As shown in the followed diagram, we have:
4444

4545
* A Kafka Broker and a set of services consuming and producing for it.
4646

47-
* An Oracle TEQ Broker with another set of services around it.
47+
* An Oracle TxEventQ Broker with another set of services around it.
4848

49-
* And connector between Kafka and Oracle TEQ enabling a communication path between them.
49+
* And connector between Kafka and Oracle TxEventQ enabling a communication path between them.
5050

51-
![Kafka and Oracle TEQ Event Mesh](images/kafka-oracle-teq-event-mesh.png " ")
51+
![Kafka and Oracle TxEventQ Event Mesh](images/kafka-oracle-txeventq-event-mesh.png " ")
5252

5353
You may now **proceed to the next lab**
5454

5555
## Want to Learn More?
5656

5757
* [Oracle Autonomous Database][ATP]
58-
* [Oracle Transactional Event Queues][TEQ]
58+
* [Oracle Transactional Event Queues][TxEventQ]
5959
* [Microservices Architecture with the Oracle Database][MicroservicesArch]
6060
* [https://developer.oracle.com/][DRC]
6161

@@ -72,11 +72,11 @@ Copyright (c) 2022 Oracle and/or its affiliates.
7272
Licensed under the Universal Permissive License v 1.0 as shown at <https://oss.oracle.com/licenses/upl>.
7373

7474
[ATP]: https://docs.oracle.com/en/cloud/paas/autonomous-database/index.html
75-
[TEQ]: https://docs.oracle.com/en/database/oracle/oracle-database/21/adque/index.html
75+
[TxEventQ]: https://docs.oracle.com/en/database/oracle/oracle-database/21/adque/index.html
7676
[kafka]: https://kafka.apache.org
7777
[okafka]: https://docs.oracle.com/en/database/oracle/oracle-database/21/adque/Kafka_cient_interface_TEQ.html#GUID-94589C97-F323-4607-8C3A-10A0EDF9DA0D
7878
[LiveLabs]: https://bit.ly/golivelabs
79-
[TEQinOracleDatabase]: https://bit.ly/TEQinOracleDatabase
79+
[TxEventQinOracleDatabase]: https://bit.ly/TxEventQinOracleDatabase
8080
[FreeTier]: https://www.oracle.com/cloud/free/faq.html
8181
[DRC]: https://developer.oracle.com
8282
[MicroservicesArch]: https://www.oracle.com/technetwork/database/availability/trn5515-microserviceswithoracle-5187372.pdf

workshops/oracleteq-kafka/cloud-setup/cmd/kafka-connect-status renamed to workshops/txeventq-kafka/cloud-setup/cmd/delete-compartment

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22
# Copyright (c) 2021 Oracle and/or its affiliates.
33
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
44

5-
curl -Ss http://localhost:8083/connectors/JmsConnectSync_teqlab/status | jq
5+
oci iam compartment delete --compartment-id "$(state_get COMPARTMENT_OCID)"

workshops/oracleteq-kafka/cloud-setup/cmd/kafka-add-topic renamed to workshops/txeventq-kafka/cloud-setup/cmd/kafka-add-topic

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# Copyright (c) 2021 Oracle and/or its affiliates.
33
# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl.
44

5-
KAFKA_TOPIC=${1:-"LABTEQTOPIC"}
5+
KAFKA_TOPIC=${1:-"LABTXEVENTQTOPIC"}
66

77
VAR=$(docker exec broker kafka-topics --bootstrap-server broker:9092 --create --topic "${KAFKA_TOPIC}")
88

0 commit comments

Comments
 (0)