github.com/influxdata/influxdb/v2@v2.7.6/replications/transport/http.go

package transport

import (
	"context"
	"net/http"

	"github.com/go-chi/chi"
	"github.com/go-chi/chi/middleware"
	"github.com/influxdata/influxdb/v2"
	"github.com/influxdata/influxdb/v2/kit/platform"
	"github.com/influxdata/influxdb/v2/kit/platform/errors"
	kithttp "github.com/influxdata/influxdb/v2/kit/transport/http"
	"github.com/influxdata/influxdb/v2/kv"
	"github.com/prometheus/client_golang/prometheus"
	"go.uber.org/zap"
)

const (
	prefixReplications = "/api/v2/replications"
)

var (
	errBadOrg = &errors.Error{
		Code: errors.EInvalid,
		Msg:  "invalid or missing org ID",
	}

	errBadRemoteID = &errors.Error{
		Code: errors.EInvalid,
		Msg:  "invalid remote ID",
	}

	errBadLocalBucketID = &errors.Error{
		Code: errors.EInvalid,
		Msg:  "invalid local bucket ID",
	}

	errBadId = &errors.Error{
		Code: errors.EInvalid,
		Msg:  "replication ID is invalid",
	}
)

type ReplicationService interface {
	// ListReplications returns all info about registered replications matching a filter.
	ListReplications(context.Context, influxdb.ReplicationListFilter) (*influxdb.Replications, error)

	// CreateReplication registers a new replication stream.
	CreateReplication(context.Context, influxdb.CreateReplicationRequest) (*influxdb.Replication, error)

	// ValidateNewReplication validates that the given settings for a replication are usable,
	// without persisting the configuration.
	ValidateNewReplication(context.Context, influxdb.CreateReplicationRequest) error

	// GetReplication returns metadata about the replication with the given ID.
	GetReplication(context.Context, platform.ID) (*influxdb.Replication, error)

	// UpdateReplication updates the settings for the replication with the given ID.
	UpdateReplication(context.Context, platform.ID, influxdb.UpdateReplicationRequest) (*influxdb.Replication, error)

	// ValidateUpdatedReplication valdiates that a replication is still usable after applying the
	// given update, without persisting the new configuration.
	ValidateUpdatedReplication(context.Context, platform.ID, influxdb.UpdateReplicationRequest) error

	// DeleteReplication deletes all info for the replication with the given ID.
	DeleteReplication(context.Context, platform.ID) error

	// ValidateReplication checks that the replication with the given ID is still usable with its
	// persisted settings.
	ValidateReplication(context.Context, platform.ID) error
}

type ReplicationHandler struct {
	chi.Router

	log *zap.Logger
	api *kithttp.API

	replicationsService ReplicationService
}

func NewInstrumentedReplicationHandler(log *zap.Logger, reg prometheus.Registerer, kv kv.Store, svc ReplicationService) *ReplicationHandler {
	// Collect telemetry
	svc = newTelemetryCollectingService(kv, svc)
	// Collect metrics.
	svc = newMetricCollectingService(reg, svc)
	// Wrap logging.
	svc = newLoggingService(log, svc)
	// Wrap authz.
	svc = newAuthCheckingService(svc)

	return newReplicationHandler(log, svc)
}

func newReplicationHandler(log *zap.Logger, svc ReplicationService) *ReplicationHandler {
	h := &ReplicationHandler{
		log:                 log,
		api:                 kithttp.NewAPI(kithttp.WithLog(log)),
		replicationsService: svc,
	}

	r := chi.NewRouter()
	r.Use(
		middleware.Recoverer,
		middleware.RequestID,
		middleware.RealIP,
	)

	r.Route("/", func(r chi.Router) {
		r.Get("/", h.handleGetReplications)
		r.Post("/", h.handlePostReplication)

		r.Route("/{id}", func(r chi.Router) {
			r.Get("/", h.handleGetReplication)
			r.Patch("/", h.handlePatchReplication)
			r.Delete("/", h.handleDeleteReplication)
			r.Post("/validate", h.handleValidateReplication)
		})
	})

	h.Router = r
	return h
}

func (h *ReplicationHandler) Prefix() string {
	return prefixReplications
}

func (h *ReplicationHandler) handleGetReplications(w http.ResponseWriter, r *http.Request) {
	q := r.URL.Query()

	// orgID is required for listing replications.
	orgID := q.Get("orgID")
	o, err := platform.IDFromString(orgID)
	if err != nil {
		h.api.Err(w, r, errBadOrg)
		return
	}

	// name, remoteID, and localBucketID are optional additional filters.
	name := q.Get("name")
	remoteID := q.Get("remoteID")
	localBucketID := q.Get("localBucketID")

	filters := influxdb.ReplicationListFilter{OrgID: *o}
	if name != "" {
		filters.Name = &name
	}
	if remoteID != "" {
		i, err := platform.IDFromString(remoteID)
		if err != nil {
			h.api.Err(w, r, errBadRemoteID)
			return
		}
		filters.RemoteID = i
	}
	if localBucketID != "" {
		i, err := platform.IDFromString(localBucketID)
		if err != nil {
			h.api.Err(w, r, errBadLocalBucketID)
			return
		}
		filters.LocalBucketID = i
	}

	rs, err := h.replicationsService.ListReplications(r.Context(), filters)
	if err != nil {
		h.api.Err(w, r, err)
		return
	}
	h.api.Respond(w, r, http.StatusOK, rs)
}

func (h *ReplicationHandler) handlePostReplication(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()
	q := r.URL.Query()

	validate := q.Get("validate") == "true"
	req := influxdb.CreateReplicationRequest{MaxQueueSizeBytes: influxdb.DefaultReplicationMaxQueueSizeBytes}
	if err := h.api.DecodeJSON(r.Body, &req); err != nil {
		h.api.Err(w, r, err)
		return
	}

	if validate {
		if err := h.replicationsService.ValidateNewReplication(ctx, req); err != nil {
			h.api.Err(w, r, err)
			return
		}
		h.api.Respond(w, r, http.StatusNoContent, nil)
		return
	}

	replication, err := h.replicationsService.CreateReplication(ctx, req)
	if err != nil {
		h.api.Err(w, r, err)
		return
	}
	h.api.Respond(w, r, http.StatusCreated, replication)
}

func (h *ReplicationHandler) handleGetReplication(w http.ResponseWriter, r *http.Request) {
	id, err := platform.IDFromString(chi.URLParam(r, "id"))
	if err != nil {
		h.api.Err(w, r, errBadId)
		return
	}

	replication, err := h.replicationsService.GetReplication(r.Context(), *id)
	if err != nil {
		h.api.Err(w, r, err)
		return
	}
	h.api.Respond(w, r, http.StatusOK, replication)
}

func (h *ReplicationHandler) handlePatchReplication(w http.ResponseWriter, r *http.Request) {
	id, err := platform.IDFromString(chi.URLParam(r, "id"))
	if err != nil {
		h.api.Err(w, r, errBadId)
		return
	}

	ctx := r.Context()
	q := r.URL.Query()

	validate := q.Get("validate") == "true"
	var req influxdb.UpdateReplicationRequest
	if err := h.api.DecodeJSON(r.Body, &req); err != nil {
		h.api.Err(w, r, err)
		return
	}

	if validate {
		if err := h.replicationsService.ValidateUpdatedReplication(ctx, *id, req); err != nil {
			h.api.Err(w, r, err)
			return
		}
		h.api.Respond(w, r, http.StatusNoContent, nil)
		return
	}

	replication, err := h.replicationsService.UpdateReplication(ctx, *id, req)
	if err != nil {
		h.api.Err(w, r, err)
		return
	}
	h.api.Respond(w, r, http.StatusOK, replication)
}

func (h *ReplicationHandler) handleDeleteReplication(w http.ResponseWriter, r *http.Request) {
	id, err := platform.IDFromString(chi.URLParam(r, "id"))
	if err != nil {
		h.api.Err(w, r, errBadId)
		return
	}

	if err := h.replicationsService.DeleteReplication(r.Context(), *id); err != nil {
		h.api.Err(w, r, err)
		return
	}
	h.api.Respond(w, r, http.StatusNoContent, nil)
}

func (h *ReplicationHandler) handleValidateReplication(w http.ResponseWriter, r *http.Request) {
	id, err := platform.IDFromString(chi.URLParam(r, "id"))
	if err != nil {
		h.api.Err(w, r, errBadId)
		return
	}

	if err := h.replicationsService.ValidateReplication(r.Context(), *id); err != nil {
		h.api.Err(w, r, err)
		return
	}
	h.api.Respond(w, r, http.StatusNoContent, nil)
}