aldettinger commented on a change in pull request #2505: URL: https://github.com/apache/camel-quarkus/pull/2505#discussion_r622444133
########## File path: docs/modules/ROOT/pages/reference/extensions/google-storage.adoc ########## @@ -0,0 +1,60 @@ +// Do not edit directly! +// This file was generated by camel-quarkus-maven-plugin:update-extension-doc-page += Google Storage +:linkattrs: +:cq-artifact-id: camel-quarkus-google-storage +:cq-native-supported: true +:cq-status: Stable +:cq-status-deprecation: Stable +:cq-description: Store and retrieve objects from Google Cloud Storage Service using the google-cloud-storage library. +:cq-deprecated: false +:cq-jvm-since: 1.9.0 +:cq-native-since: 1.9.0 + +[.badges] +[.badge-key]##JVM since##[.badge-supported]##1.9.0## [.badge-key]##Native since##[.badge-supported]##1.9.0## + +Store and retrieve objects from Google Cloud Storage Service using the google-cloud-storage library. + +== What's inside + +* xref:{cq-camel-components}::google-storage-component.adoc[Google Storage component], URI syntax: `google-storage:bucketName` + +Please refer to the above link for usage and configuration details. + +== Maven coordinates + +https://code.quarkus.io/?extension-search=camel-quarkus-google-storage[Create a new project with this extension on code.quarkus.io, window="_blank"] + +Or add the coordinates to your existing project: + +[source,xml] +---- +<dependency> + <groupId>org.apache.camel.quarkus</groupId> + <artifactId>camel-quarkus-google-storage</artifactId> +</dependency> +---- + +Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications. + +== SSL in native mode + +This extension auto-enables SSL support in native mode. Hence you do not need to add +`quarkus.ssl.native=true` to your `application.properties` yourself. See also +https://quarkus.io/guides/native-and-ssl[Quarkus SSL guide]. + +== Additional Camel Quarkus configuration + +There are two different configuration approaches: + +* Google storage client can be defined via quarkus properties leveraging the Quarkiverse - Google Cloud Services - Storage (see https://github.com/quarkiverse/quarkus-google-cloud-services/blob/main/storage[extension git page]). +Camel will autowire client into the Google-storage component. +This configuration allows definition of only one storage client, therefore it isn't possible to define several different endpoints, which run together. + +* Provide client/clients for camel registry (e.g. CDI producer/bean) and reference them from endpoint. Review comment: I would stress the point here like (if I understand correctly): When multiple storage clients are needed, quarkus properties should not be used. Instead, one or more storage client bean need to be registered in the registry (e.g. via a CDI bean producer). Each storage client bean could then be referenced from distinct endpoints. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org