Guides - Latest
チュートリアル
すぐ使い始めるための短く、焦点を絞ったエクササイズ。
Basic認証とJakarta Persistenceを使用したQuarkusアプリケーションの保護
組込のQuarkus Basic認証とJakarta Persistence IDプロバイダーを組み合わせて、ロールベースアクセス制御(RBAC)を可能にすることで、Quarkusアプリケーションエンドポイントを保護してください。
Protect a service application by using OpenID Connect (OIDC) Bearer token authentication
Here, you use the Quarkus OpenID Connect (OIDC) extension to secure a Jakarta REST application using Bearer token authentication.
Quarkus - 認可コードフローのOpenID Connectを使用してWebアプリケーションを保護
Quarkus OpenID Connect(OIDC)エクステンションを使用すると、OIDC 認可コードフローメカニズムを使用して、アプリケーションのHTTPエンドポイントを保護できます。
Your second Quarkus application
This tutorial shows you how to create an application which writes to and reads from a database.
チュートリアルの作成
架空のエクステンションからのアノテーションを使用する Quarkus アプリケーションの作成、実行、およびテストをユーザーに説明する新しいチュートリアルを作成します。
マイクロメータを用いたメトリクスの収集
Micrometer メトリクスライブラリーを使用して、ランタイム、エクステンション、アプリケーションのメトリクスを収集し、Prometheus (OpenMetrics) エンドポイントとして公開するアプリケーションを作成します。
ハウツーガイド
主要なタスク、実際の操作、一般的な問題をカバーするためのステップバイステップガイド。
Quarkusドキュメントの寄稿方法
Contribute to the documentation by using the recommended diataxis content types, steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal.
Update projects to the latest Quarkus version
Learn how to upgrade your projects to the latest version of Quarkus
コンセプト
Quarkus に関連するいくつかのより大きな概念とテクノロジーの解説。
Duplicated context, context locals, asynchronous processing and propagation
When using a traditional, blocking, and synchronous framework, processing of each request is performed in a dedicated thread.
OpenID Connect (OIDC) Bearer token authentication
Secure HTTP access to Jakarta REST (formerly known as JAX-RS) endpoints in your application with Bearer token authentication by using the Quarkus OpenID Connect (OIDC) extension.
Quarkus Security アーキテクチャー
The Quarkus Security architecture provides several built-in authentication mechanisms and is highly customizable.
Quarkus Securityの概要
Quarkus Securityでは、開発者がQuarkusアプリケーションの商用品質のセキュリティーを構築するためのアーキテクチャ、複数の認証および認可メカニズム、その他のツールを提供しているフレームワークです。
Quarkusにおけるセキュリティ脆弱性の検出と報告
Quarkusのタグの多くは、米国のNational Vulnerability Database(NVD)にCPE(Common Platform Enumeration)の名称形式で登録されています。
Quarkusの認証メカニズム
Quarkus Securityフレームワークは、複数の認証メカニズムをサポートしており、これを使用してアプリケーションを保護することができます。
Web アプリケーションを保護するための OpenID Connect 認可コードフローメカニズム
To protect your web applications, you can use the industry-standard OpenID Connect (OIDC) Authorization Code Flow mechanism provided by the Quarkus OIDC extension.
よく知られたOpenID Connect プロバイダーの設定
This document explains how to configure well-known social OIDC and OAuth2 providers.
アイデンティティ・プロバイダー
In the Quarkus Security framework, identity providers play a crucial role in authentication and authorization by verifying user identities.
リファレンス
ツール、コンポーネント、およびコマンドをカバーするテクニカルリソース。 Quarkus の百科事典。
Quarkus Cheat Sheet
Configure data sources in Quarkus
Use a unified configuration model to define datasources for Java Database Connectivity (JDBC) and Reactive drivers.
Infinispanクライアントエクステンションリファレンスガイド
Infinispanは、インメモリ分散型データストアおよびキャッシュサーバーで、柔軟な導入オプションと、データの保存、管理、処理のための堅牢な機能を提供します。
Logging configuration
Read about the use of logging API in Quarkus, configuring logging output, and using logging adapters to unify the output from other logging APIs.
Micrometerメトリクス
Use Micrometer to collect metrics produced by Quarkus, its extensions, and your application.
OpenID Connect (OIDC) 設定プロパティ
Quarkusの開発者は、src/main/resources/application.propertiesファイルに以下のプロパティを設定することで、Quarkus OpenID Connect(OIDC)エクステンションを設定します。
OpenID Connect(OIDC)およびOAuth2クライアントとフィルターリファレンスガイド
このリファレンスガイドは、以下の使用方法について説明しています。
Quarkusスタイル・コンテンツガイドライン
Guidelines are provided to help you to contribute clear and consistent content that is also sourced in the required diataxis structure and composition of Quarkus documentation.
Redis エクステンションのリファレンスガイド
Redisは、データベース、キャッシュ、ストリーミングエンジン、メッセージブローカーとして使用されるインメモリデータストアです。
Stork リファレンスガイド
このガイドは、Stork 入門ガイドの対です。
Virtual Thread support reference
This guide explains how to benefit from Java 19+ virtual threads in Quarkus application.
リアクティブメッセージング AMQP1.0 コネクターリファレンスドキュメント
このガイドは、AMQP 1.0入門の対です。
リアクティブメッセージング RabbitMQ コネクターのリファレンスドキュメント
このガイドは、RabbitMQ入門ガイドの対です。
その他のガイド
その他のQuarkusガイド
.propertiesファイルでセキュリティーを使用
このガイドでは、Quarkusアプリケーションが.propertiesファイルを使用してユーザーIDを保存する方法を説明します。
AMQP 1.0 を使用した SmallRye Reactive Messaging を使い始める
このガイドでは、QuarkusアプリケーションがSmallRye Reactive Messagingを使用してAMQPと対話する方法を説明します。
AWS Lambda SnapStart Configuration
このドキュメントでは、AWS Lambda application for SnapStartの最適化について解説します
AWS Lambda with RESTEasy Reactive, Undertow, or Reactive Routes
This guide explains how you can deploy Vert.x Web, Servlet, or RESTEasy microservices as an AWS Lambda.
Apache Kafka を使用した SmallRye Reactive Messaging の概要
このガイドでは、Quarkus アプリケーションが SmallRye Reactive Messaging を利用して Apache Kafka とやりとりする仕組みを説明します。
Apache Kafka ストリームの使用
このガイドでは、QuarkusアプリケーションでApache Kafka Streams APIを利用して、Apache Kafkaをベースにしたストリーム処理アプリケーションを実装する方法を説明します。
Apache Kafka リファレンスガイド
このリファレンスガイドでは、Apache KafkaとSmallrye Reactive Messagingフレームワークについて詳しく説明しています。
Apache Pulsar Reference Guide
This reference guide provides an in-depth look on Apache Pulsar and Smallrye Reactive Messaging framework.
Automate Quarkus deployment with Ansible
Build and deploy your Quarkus App using Ansible
Azure Functions と Funqy HTTP バインディング
サーバーレスQuarkusアプリケーションのデプロイには、Microsoft Azure FunctionsとFunqy HTTPバインディングを使用してください。
Build analytics
This guide presents what build analytics is and how to configure it.
Deploying your gRPC Service in Kubernetes
This guide explains how to deploy your gRPC services in Quarkus to Kubernetes.
Dev Services for Databases
開発モードでテストまたは実行する場合、Quarkus は設定不要のデータベースをすぐに提供できます。これは、Dev Servicesと呼ばれる機能です。
Dev Services for Pulsar
With Quarkus Smallrye Reactive Messaging Pulsar extension (quarkus-smallrye-reactive-messaging-pulsar) Dev Services for Pulsar automatically starts a Pulsar broker in dev mode and when running tests.
Dev Services for RabbitMQ
Dev Services for RabbitMQは、開発モードとテスト実行時に自動的にRabbitMQブローカーを起動します。
Dev UI
Learn how to get your extension to contribute features to the Dev UI (v2).
Elasticsearchクラスターの実行
このガイドでは、低レベルのRESTクライアントまたはElasticsearch Javaクライアントを使用して、Elasticsearchクラスタと対話する方法を説明します。
Getting Started to SmallRye Reactive Messaging with Apache Pulsar
This guide demonstrates how your Quarkus application can utilize SmallRye Reactive Messaging to interact with Apache Pulsar.
Google Cloud Functions (Serverless) with RESTEasy, Undertow, or Reactive Routes
このガイドでは、Vert.x Web、Servlet、またはRESTEasyマイクロサービスをGoogle Cloud Functionとしてデプロイする方法を説明します。
Google Cloud Functionsを使用した Funqy HTTP バインディング
FunqyのGoogle Cloud Platform FunctionsのHTTPバインディングについて解説します。
Hibernate ORMとJakarta Persistenceの使用
Hibernate ORMは、Jakarta Persistenceのデファクトの実装であり、Object Relational Mapperの全ての機能を提供します。
Hibernate Reactiveの使用
Hibernate Reactiveは、Hibernate ORMのリアクティブAPIで、ノンブロッキングデータベースドライバとデータベースとのリアクティブスタイルのインタラクションをサポートしています。
Hibernate Search ガイド
Hibernate Searchは、Elasticsearchクラスタ内のエンティティをインデックス化し、Hibernate ORMベースのすべてのアプリケーションで簡単に全文検索を提供することができます。
Hibernate Validatorによるバリデーション
このガイドでは、RESTサービスでHibernate Validator/Bean Validationを使用する方法について説明します。
JMSの使用
このガイドでは、Quarkusアプリケーションが、Apache Qpid JMSを使用してAMQP 1.0でJMSメッセージングを使用する方法、またはApache ActiveMQ Artemis JMSを使用する方法を説明します。
JSONウェブトークン (JWT) のビルド、署名、暗号化
RFC7519 によると、JSON Web トークン (JWT) は、JSON Web 署名 (JWS) 構造のペイロードとして、または JSON のプレーンテキストとして使用される JSON オブジェクトとしてエンコードされるクレームを表す、コンパクトで URL セーフな手段です。 Web 暗号化 (JWE) 構造により、クレームをデジタル署名したり、メッセージ認証コード (MAC) で完全性を保護したり、暗号化したりできます。
JWT RBAC の使用
このガイドでは、アプリケーションでSmallRye JWTを利用して、Jakarta RESTエンドポイントへのセキュアなアクセスを提供する方法について説明します。
Keycloak Admin Clientの使用
Quarkus Keycloak Admin Clientとそのreactiveの2つは、実行中のKeycloakサーバーを設定するために使用できるKeycloak Admin Clientをサポートしています。
Kubernetes で Stork を使用
このガイドでは、Kubernetes で Stork を使用してサービスの検出と負荷分散を行う方法について説明します。
Liquibase MongoDBの使用
Liquibase はデータベースのスキーマ変更管理のためのオープンソースツールで、そのMongoDB Extension を介して MongoDB データベースを管理することができます。
Mutinyによる非同期入門
Mutinyは、直感的でリアクティブなプログラミングライブラリです。
OAuth2 RBACの使用
このガイドでは、QuarkusアプリケーションでOAuth2トークンを利用して、JAX-RSエンドポイントへのセキュアなアクセスを提供する方法について説明します。
OpenAPIとSwagger UIの利用
このガイドでは、OpenAPI エクステンションを使用して OpenAPI ディスクリプタを生成し、Swagger UI フロントエンドを取得して REST エンドポイントをテストする方法を説明します。
OpenID Connect (OIDC) マルチテナンシーの使用
このガイドでは、単一のアプリケーションから複数のテナントにサービスを提供できるように、OpenID Connectアプリケーションがマルチテナントをサポートする方法を示します。
OpenID Connect Client と Token Propagation のクイックスタート
このガイドでは、OpenID ConnectとOAuth2クライアント、フィルタを使用してアクセストークンを取得、更新、伝播する方法を説明します。
OpenID Connect(OIDC)とKeycloakを使った認可の中央管理
このガイドでは、QuarkusアプリケーションがKeycloak認可サービスを使用して保護されたリソースへのアクセスを認可する方法を説明します。
OpenTelemetryの使用
このガイドでは、QuarkusアプリケーションでOpenTelemetry を使用してインタラクティブなウェブアプリケーションで分散トレースを提供する方法について説明します。
OpenTracingの使用
このガイドでは、QuarkusアプリケーションがOpenTracingを利用してインタラクティブなウェブアプリケーションのための分散トレースを提供する方法について説明します。
OptaPlanner - OptaPlanner での AI を使用したスケジュールの最適化
このガイドでは、OptaPlannerの制約解決人工知能(AI)を使用してQuarkusアプリケーションを作成するプロセスを説明します。
PanacheでJakarta RESTリソースを生成する
Hibernate ORM REST Data with Panacheは、Jakarta RESTとHibernate ORMをベースにしたCRUDアプリケーションの作成を簡素化します。
Podman と Quarkus の併用
Podmanは、Linuxシステムやその他のOS上でOCIコンテナを開発、管理、実行するためのデーモンレス、ルートレスコンテナエンジンです。
Quarkus Extension Metadata
Quarkusのエクステンションは、アプリケーションや他のライブラリが依存する可能性のあるMaven JARアーティファクトとして配布されます。
Quarkus Mavenプラグイン
Quarkus Mavenプラグインは、Quarkusアプリケーションをビルドし、開発モードの起動やネイティブ実行可能ファイルのビルドのためのヘルパーを提供します。
Quarkus SecurityとJakarta Persistence
Quarkusには、JDBC IDプロバイダーと同様に、Jakarta Persistence(旧名称JPA)IDプロバイダーが用意されています。
Quarkus Virtual Thread support for gRPC services
This guide explains how to benefit from Java virtual threads when implementing a gRPC service.
Quarkus Virtual Thread support with Reactive Messaging
This guide explains how to benefit from Java virtual threads when writing message processing applications in Quarkus.
Quarkus コマンドラインインターフェイス (CLI) を使用した Quarkus アプリの構築
Quarkus CLIを使用して、Quarkusプロジェクトのエクステンションを作成、ビルド、実行、管理します。
QuarkusアプリケーションからのEclipse Vert.x APIの使用
このガイドでは、QuarkusでVert.xを使用してリアクティブアプリケーションを構築する方法について説明します。
Quarkusベースランタイムイメージ
ネイティブ実行可能ファイルのコンテナ化を容易にするため、Quarkusには、これらの実行可能ファイルを実行するための要件を提供するベースイメージが用意されています。
Quartzによる定期的なタスクのスケジューリング
スケジュールされたタスクにクラスタリングのサポートが必要ですか?このガイドでは、そのための Quartz エクステンションの使い方を説明します。
RESTEasy Reactive を使用して REST サービスを作成する
Jakarta RESTとRESTEasy Reactiveを使用して、スケーラブルなリアクティブなRESTサービスを開発する方法を紹介します。
RESTEasy Reactive、Undertow、または Reactive Routes を使用した Azure Functions
Vert.x Web、Servlet、またはRESTEasyマイクロサービスをMicrosoft Azure Functionとしてデプロイ。
RESTEasy Reactiveへの移行
RESTEasy ClassicからRESTEasy Reactiveへの移行は、ほとんどの場合簡単ですが、いくつかの注意が必要なケースがあります。
RabbitMQによるSmallRyeリアクティブメッセージング入門
このガイドでは、QuarkusアプリケーションがSmallRye Reactive Messagingを利用してRabbitMQと対話する方法を説明します。
Schema RegistryとAvroと共にApache Kafkaを使用
Apache Kafkaを使用し、Avroでシリアル化されたレコードを使用し、スキーマレジストリに接続します。
SmallRye Stork入門
分散システムの本質は、サービス間の相互作用にあります。
SmallRyeのフォールト・トレランス
このガイドでは、QuarkusアプリケーションがSmallRye Fault Toleranceエクステンションを使用してSmallRye Fault Tolerance仕様を使用する方法を説明します。
Spring BootプロパティAPIでアプリケーションのプロパティにアクセスする
MicroProfile Config アノテーションの代わりに Spring Boot の @ConfigurationProperties
を使用します
Spring Cache APIのためのQuarkusエクステンション
アプリケーションレベルのキャッシングにはCacheエクステンションを使用することが推奨されていますが、QuarkusはSpring Cacheエクステンションの形でSpring Cacheの互換性レイヤーを提供しています。
Spring Cloud Config Serverからのプロパティの読み込み
Quarkusは、Spring-cloud-config-clientエクステンションの形でSpring Cloud Config用の互換性レイヤーを提供しています。
Spring DI APIのためのQuarkusエクステンション
インジェクションにはCDIアノテーションを使用することが推奨されていますが、Quarkusはspring-diエクステンションの形でSpring依存性インジェクション用の互換性レイヤーを提供しています。
Spring Data API のエクステンション
データレイヤーにはHibernate ORM with Panacheを使用することが推奨されていますが、Quarkusはspring-data-jpaエクステンションの形でSpring Data JPAの互換性レイヤーを提供しています。
Spring Data RESTのエクステンション
Spring Data RESTは、当社のSpring Data互換性レイヤをベースにCRUDアプリケーションの作成を簡素化します。
Spring Scheduling APIのためのQuarkus Extension
SchedulerやQuartzのエクステンションを使ってタスクをスケジュールすることが推奨されていますが、QuarkusはSpring-scheduledエクステンションの形でSpring Scheduledとの互換性のあるレイヤーを提供しています。
Spring Security API の Quarkus エクステンション
Quarkus Securityレイヤーを使用してアプリケーションを保護することが推奨されていますが、Quarkusはspring-securityのエクステンションの形でSpring Securityとの互換性のあるレイヤーを提供しています。
Spring Web APIのためのQuarkus エクステンション
RESTエンドポイントの定義にはJakarta RESTアノテーションを使用することが推奨されていますが、QuarkusはSpring-webエクステンションという形でSpring Webとの互換性のあるレイヤーを提供しています。
UPXでネイティブ実行可能ファイルを圧縮
Ultimate Packer for eXecutables (UPX) は、実行可能ファイルのサイズを縮小する圧縮ツールです。
WebAuthnでセキュリティを使用
このガイドでは、Quarkus アプリケーションで、パスワードの代わりに WebAuthn 認証を使用する方法を説明します。
エクステンション Codestart
code.quarkus.ioや、すべてのQuarkusツールでQuarkusアプリケーションを生成する際に、エクステンション用の初期コードをユーザーに提供する。
クロスサイトリクエストフォージェリー対策
クロスサイトリクエストフォージェリ(CSRF)は、エンドユーザーが現在認証されているウェブアプリケーション上で望まない動作を実行させる攻撃です。
コンテキストと依存性注入(CDI)の紹介
Quarkus DI solution is based on the Jakarta Contexts and Dependency Injection 4.0 specification.
コンテナーイメージ
Learn how to build and push container images with Jib, OpenShift or Docker as part of the Quarkus build.
シンプルになったHibernate ORM with Panache
Hibernate ORMは、Jakarta Persistenceのデファクトの実装であり、Object Relational Mapperの全ての機能を提供します。
シンプルになったHibernate ORM with PanacheとKotlin
KotlinプロジェクトでHibernate ORM with Panacheを使う場合に固有の事項について説明します。
シンプルになったMongoDB with PanacheとKotlin
このガイドでは、Kotlinプロジェクトでアクティブレコードやリポジトリを使ったMongoDBの使い方について説明します。
セキュリティのテスト
このドキュメントでは、Quarkus Securityのテスト方法について説明します。
ネイティブイメージでのSSLの利用
このガイドでは、ネイティブイメージがそのままではSSLをサポートしていないため、ネイティブイメージをSSLに対応させる方法について説明します。
ネイティブ・アプリケーションを作成するためのヒント
このガイドは、アプリケーションをネイティブ実行可能ファイルにコンパイルする際に遭遇する問題を解決するためのヒントをまとめたものです。
マルチパートでのRESTクライアントの使用
このガイドでは、RESTEasy REST クライアントを使用してマルチパート REST リクエストを送信する方法、典型的にはドキュメントをアップロードする方法を説明します。
レガシーREST クライアントの利用
このガイドでは、RESTEasy REST Clientを使ってREST API(JSONなど)とほとんど手間をかけずにやりとりする方法を説明しています。
ログの一元管理(Graylog、Logstash、Fluentd)
このガイドでは、Graylog Extended Log Format (GELF) を使用して Logstash または Fluentd でログを集中管理する方法を説明します。