Skip to content

Commit

Permalink
Force push for zip
Browse files Browse the repository at this point in the history
  • Loading branch information
agoncal committed Oct 13, 2023
2 parents 5659b57 + b9049fb commit b9a5747
Show file tree
Hide file tree
Showing 29 changed files with 478 additions and 698 deletions.
3 changes: 0 additions & 3 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -83,9 +83,6 @@ jobs:
cp -r target/generated-asciidoc/mac/variants/* target/generated-asciidoc/variants
cp -r target/generated-asciidoc/windows/variants/* target/generated-asciidoc/variants
# make an index.html
cp target/generated-asciidoc/spine-azure.html target/generated-asciidoc/index-azure.html
# Move things around to preserve the super-heroes structure
mkdir -p target/site/super-heroes
cp -R target/generated-asciidoc/* target/site/super-heroes
Expand Down
19 changes: 12 additions & 7 deletions quarkus-workshop-super-heroes/README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,21 @@ Build and deploy a microservice architecture where Super Heroes fight against Su

== Instructions

There are several workshops available that you can follow depending your needs:
There are several versions of this workshops available that you can follow depending your needs:

* _Develop the Super Heroes with Quarkus_:
If you are a developer, are new to quarkus, then this workshop might interest you.
You will develop, from scratch, a set of microservices accessing databases, Kafka channels and exposing APIs.
Check https://quarkus.io/quarkus-workshops/super-heroes/index.html to get the workshop instructions.
* _Deploy the Super Heroes to Azure Container Apps_:
If you are interested in deploying an already made application to Azure Container Apps, then this workshop is for you.
You will not develop any Quarkus (you don't even need Java tools), but you will be pushing Docker containers, creating managed services on Azure (databases, Kafka) and monitoring the entire system (https://docs.microsoft.com/en-us/events/jdconf-2022/quarkus-superheroes-on-azure[watch a video presenting the workshop]).
Check https://quarkus.io/quarkus-workshops/super-heroes/index-azure.html to get the workshop instructions.
You will develop, from scratch, a set of microservices accessing databasesand exposing APIs.
* _Create an AI-integration service_
* _Deploy the microservices to Azure Container Apps_
* _Containerize the microservices_
* _Contract testing with Pact_
* _Write a Quarkus extension_
* _Write a Quarkus extension_
* _Run Quarkus on Kubernetes_
* _Messaging with Kafka_
* _Native compilation_
* _Observability_

== Start the infrastructure

Expand Down
22 changes: 3 additions & 19 deletions quarkus-workshop-super-heroes/docs/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ The default build will take around 50m.
<semantic-kernel.version>0.2.9-alpha</semantic-kernel.version>
<compiler-plugin.version>3.11.0</compiler-plugin.version>
<surefire-plugin.version>3.1.2</surefire-plugin.version>
<exec-plugin.version>3.1.0</exec-plugin.version>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.build.timestamp.format>yyyy-MM-dd</maven.build.timestamp.format>
Expand Down Expand Up @@ -216,25 +217,6 @@ The default build will take around 50m.
</attributes>
</configuration>
</execution>
<execution>
<!-- When we do #302, we can turn azure into an attribute and use the same spine.html
For now, we just build a single copy of it-->
<id>output-html-azure</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<sourceDocumentName>spine-azure.adoc</sourceDocumentName>
<outputDirectory>
${project.build.directory}/generated-asciidoc/
</outputDirectory>
<attributes>
<options-file>default-options.adoc</options-file>
<imagesdir>images</imagesdir> <!-- I don't know why this has to be specified as one level above the plantuml dir, when they're siblings, but it does -->
</attributes>
</configuration>
</execution>
</executions>
</plugin>

Expand All @@ -244,6 +226,7 @@ The default build will take around 50m.
<plugin>
<artifactId>exec-maven-plugin</artifactId>
<groupId>org.codehaus.mojo</groupId>
<version>${exec-plugin.version}</version>
<executions>
<execution>
<phase>generate-sources</phase>
Expand Down Expand Up @@ -347,6 +330,7 @@ The default build will take around 50m.
<plugin>
<artifactId>exec-maven-plugin</artifactId>
<groupId>org.codehaus.mojo</groupId>
<version>${exec-plugin.version}</version>
<executions>
<execution>
<phase>generate-sources</phase>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,25 @@ samp {
.content-area {
margin-left: var(--site-margins);
margin-right: var(--site-margins);
width: 60%;
display: flex;
flex-direction: row;
column-gap: 1em;

}

.mode {
width: 50%;
padding-top: 0em;
padding-left: 4em;
padding-right: 4em;
margin: 3em;
display: flex;
flex-direction: column;
justify-content: center;
}

.right {
border-left: 1px lightgrey solid;
}

.cta > .content {
Expand Down Expand Up @@ -244,13 +262,25 @@ button:hover {
}

.big {
width: 60%;
margin-top: 1em;
width: 95%;
height: 60px;
margin-top: 2em;
margin-bottom: 1em;
padding: 1em;
font-size: 1.2em;
display: flex;
align-items: center;
justify-content: center;
}

.no-underline {
border: none;
}

.squish {
margin-top: 0rem;
padding-top: 0rem;
}

/*See here for the list of unicode codes for fontawesome*/
/*https://fontawesome.com/v5/cheatsheet*/
Expand Down Expand Up @@ -307,5 +337,7 @@ pre code, pre pre {
}

ul.configurator {
list-style-type: none;
list-style-type: none;
padding-bottom: 0;
margin-bottom: 0;
}
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,6 @@
* https://quarkus.io
* https://code.quarkus.io
* https://quarkus.io/guides/all-config
* https://azure.microsoft.com/services/container-apps[Azure Container Apps Overview]
* https://docs.microsoft.com/azure/container-apps[Azure Container Apps Documentation]
* https://github.com/ozangunalp/managed-kafka-quarkus/tree/main/azure-event-hub[Managed Kafka Quarkus]
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ https://docs.microsoft.com/windows/wsl[Windows Subsystem for Linux] (WSL) lets d

[WARNING]
====
If you are using Windows, it is recommended to install WSL.
If you are using Windows, it is recommended to install WSL as all the commands use bash.
====

== Installing WSL
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@ ifdef::use-ai[]
include::introduction-installing-ai.adoc[leveloffset=+1]
endif::use-ai[]

ifdef::use-windows[]
include::introduction-installing-wsl.adoc[leveloffset=+1]
endif::use-windows[]

ifdef::use-azure[]
include::introduction-installing-azure-cli.adoc[leveloffset=+1]
endif::use-azure[]

== Recap

Before going further, make sure the following commands work on your machine.
Expand All @@ -33,6 +41,9 @@ docker compose version
ifdef::use-local-kubernetes[]
kubectl version # If you used Rancher Desktop and plan to use Kubernetes
endif::use-local-kubernetes[]
ifdef::use-azure[]
az --version
endif::use-azure[]
----

We have not mentioned cURL up to now, because most modern operating systems ship with it pre-installed.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,14 @@ ifdef::use-observability[]
* _Observability_:
in this section, you will add metrics, health checks, and distributed tracing to your microservices
endif::use-observability[]
ifdef::use-azure[]
* _Azure Container Apps and Quarkus_:
this section introduces Quarkus and Azure Container Apps to make sure you have all the needed vocabulary to follow along
* _Running the Application Locally_:
in this section, you will build Docker images out of Quarkus microservices, execute them locally with Docker compose, push them to Azure Registry, all that using Docker and Azure CLI
* _Running the Application on Azure Container Apps_:
in this section, you will create an entire infrastructure on Azure (Postgres databases, Kafka, etc.) and deploy the microservices to Azure Container Apps
endif::use-azure[]
ifdef::use-extension[]
* _Extending Quarkus_:
in this section, you will create a Quarkus extension
Expand Down Expand Up @@ -169,6 +177,9 @@ endif::use-native[]
ifdef::use-ai[]
* OpenAI or Azure OpenAI keys (optional, only if you want to use the narration feature)
endif::use-ai[]
ifdef::use-azure[]
* An Azure subscription and the Azure CLI
endif::use-azure[]

We will also be using Maven {maven-version}, but there is no
need to install it. Instead, the workshop scaffolding includes
Expand All @@ -181,5 +192,5 @@ You can skip the next section if you have already installed all the prerequisite
[WARNING]
====
This workshop assumes a bash shell.
ifdef::use-windows[If you run on Windows, in particular, adjust the commands accordingly.]
ifdef::use-windows[If you run on Windows, in particular, adjust the commands accordingly or install WSL.]
====
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,9 @@ endif::use-messaging[]
ifdef::use-ai[]
* Use OpenAI to introduce some artificial intelligence
endif::use-ai[]
ifdef::use-azure[]
* Deploy the entire application to Azure Container Apps
endif::use-azure[]
* Answer the ultimate question: are super-heroes stronger than super-villains?
This workshop is a BYOL (_Bring Your Own Laptop_) session, so bring your Windows, OSX, or Linux laptop.
Expand Down Expand Up @@ -60,6 +63,13 @@ endif::use-kubernetes[]
ifdef::use-observability[]
* How to monitor your microservices with Prometheus
endif::use-observability[]
ifdef::use-azure[]
* What is Azure Container Apps
* How to push the Docker images to Azure Registry
* How to create managed services in Azure (Postgres database, Kafka)
* How to deploy microservices to Azure Container Apps
* How to configure Docker images in Azure Container Apps
endif::use-azure[]
ifdef::use-extension[]
* How to extend Quarkus with extensions
endif::use-extension[]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
:os: all
:use-native:
:use-ai:
:use-kubernetes:
:use-azure:
:use-container:
:use-contract-testing:
:use-extension:
:use-kubernetes:
:use-messaging:
:use-native:
:use-observability:
Loading

0 comments on commit b9a5747

Please sign in to comment.