Guides - Latest
チュートリアル
すぐ使い始めるための短く、焦点を絞ったエクササイズ。
Basic認証とJakarta Persistenceを使用したQuarkusアプリケーションの保護
組込のQuarkus Basic認証とJakarta Persistence IDプロバイダーを組み合わせて、ロールベースアクセス制御(RBAC)を可能にすることで、Quarkusアプリケーションエンドポイントを保護してください。
OpenID Connect(OIDC)ベアラー認証を使用したサービスアプリケーションの保護
ここでは、Quarkus OpenID Connect (OIDC) エクステンションを使用して、ベアラー認証を使用して Jakarta REST アプリケーションを保護します。
Quarkus - 認可コードフローのOpenID Connectを使用してWebアプリケーションを保護
Quarkus OpenID Connect(OIDC)エクステンションを使用すると、OIDC 認可コードフローメカニズムを使用して、アプリケーションのHTTPエンドポイントを保護できます。
チュートリアルの作成
架空のエクステンションからのアノテーションを使用する Quarkus アプリケーションの作成、実行、およびテストをユーザーに説明する新しいチュートリアルを作成します。
マイクロメータを用いたメトリクスの収集
Micrometer メトリクスライブラリーを使用して、ランタイム、エクステンション、アプリケーションのメトリクスを収集し、Prometheus (OpenMetrics) エンドポイントとして公開するアプリケーションを作成します。
ハウツーガイド
主要なタスク、実際の操作、一般的な問題をカバーするためのステップバイステップガイド。
Quarkusドキュメントの寄稿方法
推奨される手順、ワークフロー、スタイルガイダンスを使用して、Quarkusウェブサイトのポータルでコンテンツが正常にレンダリングされるようにし、ドキュメントを寄稿します。
コンセプト
Quarkus に関連するいくつかのより大きな概念とテクノロジーの解説。
OpenID Connect (OIDC) ベアラー認証
Quarkus OpenID Connect(OIDC)エクステンションを使用して、Bearer認証でアプリケーションのJakarta REST(旧称:JAX-RS)エンドポイントへのHTTPアクセスを保護してください。
Quarkus SecurityとJakarta Persistence
Quarkusには、JDBC IDプロバイダーと同様に、Jakarta Persistence(旧名称JPA)IDプロバイダーが用意されています。
Quarkus Securityの概要
Quarkus Securityでは、開発者がQuarkusアプリケーションの商用品質のセキュリティーを構築するためのアーキテクチャ、複数の認証および認可メカニズム、その他のツールを提供しているフレームワークです。
Quarkusにおけるセキュリティ脆弱性の検出と報告
Quarkusのタグの多くは、米国のNational Vulnerability Database(NVD)にCPE(Common Platform Enumeration)の名称形式で登録されています。
Quarkusの認証メカニズム
Quarkus Securityフレームワークは、複数の認証メカニズムをサポートしており、これを使用してアプリケーションを保護することができます。
Web アプリケーションを保護するための OpenID Connect 認可コードフローメカニズム
Webアプリケーションを保護するために、Quarkus OpenID Connect(OIDC)エクステンションで提供される認証コードフローメカニズムを使用することができます。
WebAuthnでセキュリティを使用
このガイドでは、Quarkus アプリケーションで、パスワードの代わりに WebAuthn 認証を使用する方法を説明します。
アイデンティティ・プロバイダー
Quarkus Securityフレームワークでは、IDプロバイダーは認証と認可において重要な役割を果たし、ユーザーIDの保存と検証のためのサービスを提供します。
リファレンス
ツール、コンポーネント、およびコマンドをカバーするテクニカルリソース。 Quarkus の百科事典。
Quarkus Cheat Sheet
Infinispanクライアントエクステンションリファレンスガイド
Infinispanは、インメモリ分散型データストアおよびキャッシュサーバーで、柔軟な導入オプションと、データの保存、管理、処理のための堅牢な機能を提供します。
OpenID Connect (OIDC) 設定プロパティ
Quarkusの開発者は、src/main/resources/application.propertiesファイルに以下のプロパティを設定することで、Quarkus OpenID Connect(OIDC)エクステンションを設定します。
OpenID Connect(OIDC)およびOAuth2クライアントとフィルターリファレンスガイド
このリファレンスガイドは、以下の使用方法について説明しています。
Quarkusスタイル・コンテンツガイドライン
ガイドラインは、Quarkus ドキュメントの必要な構造と構成をソースとする明確で一貫性のあるコンテンツを提供するのに役立つように提供されています。
Redis エクステンションのリファレンスガイド
Redisは、データベース、キャッシュ、ストリーミングエンジン、メッセージブローカーとして使用されるインメモリデータストアです。
Stork リファレンスガイド
このガイドは、Stork 入門ガイドの対です。
ネイティブリファレンスガイド
このガイドは、ネイティブ実行可能ファイルのビルド、ネイティブイメージでのSSLの使用、ネイティブアプリケーションの作成の各ガイドの対となるものです。
リアクティブメッセージング AMQP1.0 コネクターリファレンスドキュメント
このガイドは、AMQP 1.0入門の対です。
リアクティブメッセージング RabbitMQ コネクターのリファレンスドキュメント
このガイドは、RabbitMQ入門ガイドの対です。
その他のガイド
その他のQuarkusガイド
.propertiesファイルでセキュリティーを使用
このガイドでは、Quarkusアプリケーションが.propertiesファイルを使用してユーザーIDを保存する方法を説明します。
AMQP 1.0 を使用した SmallRye Reactive Messaging を使い始める
このガイドでは、QuarkusアプリケーションがSmallRye Reactive Messagingを使用してAMQPと対話する方法を説明します。
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フレームワークについて詳しく説明しています。
Automate Quarkus deployment with Ansible
Build and deploy your Quarkus App using Ansible
Azure Functions と Funqy HTTP バインディング
サーバーレスQuarkusアプリケーションのデプロイには、Microsoft Azure FunctionsとFunqy HTTPバインディングを使用してください。
Dev Services for Databases
開発モードでテストまたは実行する場合、Quarkus は設定不要のデータベースをすぐに提供できます。これは、Dev Servicesと呼ばれる機能です。
Dev Services for Elasticsearch
Elasticsearch関連のエクステンションがある場合(例:
Dev Services for RabbitMQ
Dev Services for RabbitMQは、開発モードとテスト実行時に自動的にRabbitMQブローカーを起動します。
Elasticsearchクラスターの実行
このガイドでは、低レベルのRESTクライアントまたはElasticsearch Javaクライアントを使用して、Elasticsearchクラスタと対話する方法を説明します。
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バインディングについて解説します。
Gradleを使ってQuarkusアプリをビルドする
このガイドでは、次をカバーします:Gradleの設定、新しいプロジェクトの作成、エクステンションの扱い、開発モード、デバッグ、IDEでのインポート、ネイティブイメージのビルド、コンテナに適した実行可能ファイルのビルド
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を使用する方法を説明します。
JReleaser によるパッケージングとリリース
このガイドでは、JReleaserツールを使用したCLIアプリケーションのパッケージングとリリースについて説明します。
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 データベースを管理することができます。
Maven を使ったアプリケーションの構築
このガイドでは、次をカバーします:Mavenの設定、新規プロジェクトの作成、エクステンションの扱い、開発モード、デバッグ、IDEでのインポート、ネイティブイメージのビルド、コンテナに適した実行可能ファイルのビルド
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 コマンドラインインターフェイス (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 を使用した Amazon Lambda
このガイドでは、Vert.x Web、Servlet、またはRESTEasyマイクロサービスをAmazon Lambdaとしてデプロイする方法を説明します。
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) は、実行可能ファイルのサイズを縮小する圧縮ツールです。
Update projects to the latest version of Quarkus
Update your projects to the latest version of Quarkus
エクステンション Codestart
code.quarkus.ioや、すべてのQuarkusツールでQuarkusアプリケーションを生成する際に、エクステンション用の初期コードをユーザーに提供する。
クロスサイトリクエストフォージェリー対策
クロスサイトリクエストフォージェリ(CSRF)は、エンドユーザーが現在認証されているウェブアプリケーション上で望まない動作を実行させる攻撃です。
コンテキストと依存性注入(CDI)の紹介
Quarkus DIソリューションは、Contexts and Dependency Injection for Java 2.0 仕様に基づきます。
シンプルになった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 でログを集中管理する方法を説明します。
仮想スレッドを使ったさらにシンプルなQuarkusでのリアクティブRESTサービスの作成
このガイドではQuarkusでRESTサービスを記述する際にJava 19の仮想スレッドを利用する方法について説明します。