Skip to content

Commit 2a0071e

Browse files
Use correct asciidoc heder number to avoid warning
1 parent 9a25960 commit 2a0071e

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

_posts/2023-06-23-quarkus-cli.adoc

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ and will be the focus of this post. In particular, this post is about building c
3131
the Quarkus CLI.
3232

3333

34-
=== Building container images using the Quarkus CLI ===
34+
== Building container images using the Quarkus CLI ==
3535
Providing a simple way for creating container images with Quarkus is not something new. Since, its early days Quarkus provided extensions
3636
that took care of building container images with technologies like:
3737

@@ -62,7 +62,7 @@ This is trivial, but something that should be optional as the actual application
6262
Also, it can potentially increase the noise in the version control log.
6363

6464

65-
==== Building container images using the Quarkus CLI ====
65+
=== Building container images using the Quarkus CLI ===
6666
Quarkus 3.0 introduces an alternative way of building container images using the Quarkus CLI. In the recent version of the CLI new sub commands are available for building and pushing container images.
6767
These are listed in the output of `quarkus --help`.
6868

@@ -110,7 +110,7 @@ quarkus image build jib --help
110110
----
111111

112112

113-
==== Deploying applications ====
113+
=== Deploying applications ===
114114
In a way similar to building container images Quarkus allowed the application deployment to platforms like https://kubernetes.io[Kubernetes] and https://openshift.com[OpenShift].
115115
Again, this is something the required the use of extensions and additional build options to enable deployment.
116116
For example to deploy an application on https://kubernetes.io[Kubernetes] one needed to explicitly add the extension to the project and enable deployment using the `quarkus.kubernetes.deploy` property.
@@ -122,7 +122,7 @@ quarkus ext add quarkus-kubernetes
122122
----
123123

124124

125-
==== Deploying using the Quarkus CLI ====
125+
=== Deploying using the Quarkus CLI ===
126126
In Quarkus 3.0 the CLI includes the `deploy` sub command that is the entry point to commands related to deployment.
127127
Using `quarkus --help` one can list all the related commands:
128128

@@ -152,19 +152,19 @@ quarkus deploy kind
152152
It's important to note, that by having a command per platform, users can easily set platform specific configuration when executing these commands (see the `--help` output).
153153

154154

155-
==== Summarizing image building and deployment commands ====
155+
=== Summarizing image building and deployment commands ===
156156
Quarkus 3.0 introduces new CLI commands for building container images and deploying. The commands improve the developer experience as they eliminate steps related to project
157157
setup and configuration. They allow developers to easily experiment with different technologies and guide them by providing help messages, hints and completion.
158158

159159
Future releases of Quarkus will expand this concept to cover areas like https://quarkus.io/guides/azure-functions[Quarkus Azure Functions] and https://quarkus.io/guides/amazon-lambda[Quarkus Amazon Lambda].
160160

161161

162-
==== CLI Plugins ====
162+
=== CLI Plugins ===
163163
The CLI brings some really interesting features for Developers, but unfortunately it can't grow indefinitely as it needs to be reasonably sized.
164164
This need lead to the implementation of a plugin system for the CLI, that allows the dynamic addition of commands in the form of plugins.
165165

166166

167-
===== What is a Plugin ? =====
167+
==== What is a Plugin ? ====
168168
A plugin implements a command in one of the following ways:
169169

170170
* As an arbitrary executable
@@ -213,7 +213,7 @@ The plugins listed are https://www.jbang.dev/[JBang] aliases that are available
213213
More catalogs can be added using the https://www.jbang.dev/[JBang] binary.
214214

215215

216-
===== Writing plugins =====
216+
==== Writing plugins ====
217217
Let's see how to create a plugin for the Quarkus CLI. Out of the box the Quarkus CLI provides 3 ways of creating projects:
218218

219219
* A webapp
@@ -310,7 +310,7 @@ quarkus create from-quickstart hibernate-orm-panache-quickstart
310310
----
311311

312312

313-
===== Using your Java skills to write plugins =====
313+
==== Using your Java skills to write plugins ====
314314
Using shell scripts or arbitrary binaries (written in any language) is one of writing plugins.
315315
Java developers can alternatively put their java skills to use.
316316
Any source file that contains a main or any jar that defines a main class can be used directly by passing their location (Path or URL).
@@ -415,7 +415,7 @@ Added plugin:
415415
----
416416

417417

418-
===== Project specific plugins =====
418+
==== Project specific plugins ====
419419
In all the examples so far the plugins listed as `user scoped`. This means that the plugins are global to the user. It is possible however to also have `project scoped` plugins.
420420
This is important as it allows:
421421

@@ -558,7 +558,7 @@ quarkus plug add bin/quarkus-argocds-setup
558558
Now by calling `quarkus argocd-setup` the application is setup for use with https://argoproj.github.io/cd/[ArgoCD].
559559

560560

561-
===== Extension provided plugins =====
561+
==== Extension provided plugins ====
562562
A Quarkus extension may contribute to the CLI plugins that are available to a project.
563563
At the moment the following Quarkiverse extensions provide plugins:
564564

@@ -599,12 +599,12 @@ quarkus helm install
599599
----
600600

601601

602-
===== Summarizing plugins =====
602+
==== Summarizing plugins ====
603603
The Quarkus CLI plugin system is not just a way for the Quarkus team to rightsize and modularize the Quarkus CLI, it also offers teams a way of creating
604604
scripts and recipes specific to their project and distribute them along with the code.
605605

606606

607-
=== See also ===
607+
== See also ==
608608
If you want to see more about the new Quarkus CLI features make sure to check the following https://quarkus.io/insights/[Quarkus Insights] episodes.
609609
They demonstrate the new features in action and will hopefully inspire you with ideas for your own plugins.
610610

0 commit comments

Comments
 (0)