/* * Copyright (C) 2022-present ScyllaDB */ /* * SPDX-License-Identifier: LicenseRef-ScyllaDB-Source-Available-1.0 */ #pragma once #include #include #include #include #include #include #include #include "utils/lister.hh" #include "utils/s3/creds.hh" #include "credentials_providers/aws_credentials_provider_chain.hh" #include "s3_retry_strategy.hh" #include "utils/exceptions.hh" #include "retryable_http_client.hh" #include "utils/s3/client_fwd.hh" using namespace seastar; class memory_data_sink_buffers; namespace s3 { using s3_clock = std::chrono::steady_clock; struct range { uint64_t off; size_t len; }; struct tag { std::string key; std::string value; auto operator<=>(const tag&) const = default; }; using tag_set = std::vector; struct stats { uint64_t size; std::time_t last_modified; }; future<> ignore_reply(const http::reply& rep, input_stream&& in_); [[noreturn]] void map_s3_client_exception(std::exception_ptr ex); class client : public enable_shared_from_this { class multipart_upload; class copy_s3_object; class upload_sink_base; class upload_sink; class upload_jumbo_sink; class download_source; class do_upload_file; class readable_file; std::string _host; endpoint_config_ptr _cfg; semaphore _creds_sem; timer _creds_invalidation_timer; timer _creds_update_timer; aws_credentials _credentials; aws::aws_credentials_provider_chain _creds_provider_chain; struct io_stats { uint64_t ops = 0; uint64_t bytes = 0; std::chrono::duration duration = std::chrono::duration(0); void update(uint64_t len, std::chrono::duration lat) { ops++; bytes += len; duration += lat; } }; struct group_client { aws::retryable_http_client retryable_client; io_stats read_stats; io_stats write_stats; seastar::metrics::metric_groups metrics; group_client(std::unique_ptr f, unsigned max_conn, const aws::retry_strategy& retry_strategy); void register_metrics(std::string class_name, std::string host); }; std::unordered_map _https; using global_factory = std::function(std::string)>; global_factory _gf; semaphore& _memory; std::unique_ptr _retry_strategy; struct private_tag {}; future> claim_memory(size_t mem); future<> update_credentials_and_rearm(); future<> authorize(http::request&); group_client& find_or_create_client(); future<> make_request(http::request req, http::experimental::client::reply_handler handle = ignore_reply, std::optional expected = std::nullopt, seastar::abort_source* = nullptr); using reply_handler_ext = noncopyable_function(group_client&, const http::reply&, input_stream&& body)>; future<> make_request(http::request req, reply_handler_ext handle, std::optional expected = std::nullopt, seastar::abort_source* = nullptr); future<> get_object_header(sstring object_name, http::experimental::client::reply_handler handler, seastar::abort_source* = nullptr); public: client(std::string host, endpoint_config_ptr cfg, semaphore& mem, global_factory gf, private_tag, std::unique_ptr rs = nullptr); static shared_ptr make(std::string endpoint, endpoint_config_ptr cfg, semaphore& memory, global_factory gf = {}); future get_object_size(sstring object_name, seastar::abort_source* = nullptr); future get_object_stats(sstring object_name, seastar::abort_source* = nullptr); future get_object_tagging(sstring object_name, seastar::abort_source* = nullptr); future<> put_object_tagging(sstring object_name, tag_set tagging, seastar::abort_source* = nullptr); future<> delete_object_tagging(sstring object_name, seastar::abort_source* = nullptr); future> get_object_contiguous(sstring object_name, std::optional range = {}, seastar::abort_source* = nullptr); future<> put_object(sstring object_name, temporary_buffer buf, seastar::abort_source* = nullptr); future<> put_object(sstring object_name, ::memory_data_sink_buffers bufs, seastar::abort_source* = nullptr); future<> copy_object(sstring source_object, sstring target_object, std::optional part_size = {}, std::optional tag = {}, seastar::abort_source* = nullptr); future<> delete_object(sstring object_name, seastar::abort_source* = nullptr); file make_readable_file(sstring object_name, seastar::abort_source* = nullptr); data_sink make_upload_sink(sstring object_name, seastar::abort_source* = nullptr); data_sink make_upload_jumbo_sink(sstring object_name, std::optional max_parts_per_piece = {}, seastar::abort_source* = nullptr); data_source make_download_source(sstring object_name, std::optional range = {}, seastar::abort_source* = nullptr); /// upload a file with specified path to s3 /// /// @param path the path to the file /// @param object_name object name for the created object in S3 /// @param tag an optional tag /// @param part_size the size of each part of the multipart upload future<> upload_file(std::filesystem::path path, sstring object_name, std::optional tag = {}, std::optional max_part_size = {}, seastar::abort_source* = nullptr); future<> upload_file(std::filesystem::path path, sstring object_name, upload_progress& up, seastar::abort_source* = nullptr); future<> update_config(endpoint_config_ptr); struct handle { std::string _host; global_factory _gf; public: handle(const client& cln) : _host(cln._host) , _gf(cln._gf) {} shared_ptr to_client() && { return _gf(std::move(_host)); } }; class bucket_lister final : public abstract_lister::impl { shared_ptr _client; sstring _bucket; sstring _prefix; sstring _max_keys; std::optional> _opt_done_fut; lister::filter_type _filter; seastar::queue> _queue; future<> start_listing(); public: bucket_lister(shared_ptr client, sstring bucket, sstring prefix = "", size_t objects_per_page = 64, size_t entries_batch = 512 / sizeof(std::optional)); bucket_lister(shared_ptr client, sstring bucket, sstring prefix, lister::filter_type filter, size_t objects_per_page = 64, size_t entries_batch = 512 / sizeof(std::optional)); future> get() override; future<> close() noexcept override; }; future<> close(); }; } // s3 namespace