mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-11-04 05:42:25 -06:00 
			
		
		
		
	
		
			
				
	
	
		
			355 lines
		
	
	
	
		
			10 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			355 lines
		
	
	
	
		
			10 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
/*
 | 
						|
 * MinIO Go Library for Amazon S3 Compatible Cloud Storage
 | 
						|
 * Copyright 2020 MinIO, Inc.
 | 
						|
 *
 | 
						|
 * Licensed under the Apache License, Version 2.0 (the "License");
 | 
						|
 * you may not use this file except in compliance with the License.
 | 
						|
 * You may obtain a copy of the License at
 | 
						|
 *
 | 
						|
 *     http://www.apache.org/licenses/LICENSE-2.0
 | 
						|
 *
 | 
						|
 * Unless required by applicable law or agreed to in writing, software
 | 
						|
 * distributed under the License is distributed on an "AS IS" BASIS,
 | 
						|
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
						|
 * See the License for the specific language governing permissions and
 | 
						|
 * limitations under the License.
 | 
						|
 */
 | 
						|
 | 
						|
package minio
 | 
						|
 | 
						|
import (
 | 
						|
	"bytes"
 | 
						|
	"context"
 | 
						|
	"encoding/json"
 | 
						|
	"encoding/xml"
 | 
						|
	"io"
 | 
						|
	"net/http"
 | 
						|
	"net/url"
 | 
						|
	"time"
 | 
						|
 | 
						|
	"github.com/google/uuid"
 | 
						|
	"github.com/minio/minio-go/v7/pkg/replication"
 | 
						|
	"github.com/minio/minio-go/v7/pkg/s3utils"
 | 
						|
)
 | 
						|
 | 
						|
// RemoveBucketReplication removes a replication config on an existing bucket.
 | 
						|
func (c *Client) RemoveBucketReplication(ctx context.Context, bucketName string) error {
 | 
						|
	return c.removeBucketReplication(ctx, bucketName)
 | 
						|
}
 | 
						|
 | 
						|
// SetBucketReplication sets a replication config on an existing bucket.
 | 
						|
func (c *Client) SetBucketReplication(ctx context.Context, bucketName string, cfg replication.Config) error {
 | 
						|
	// Input validation.
 | 
						|
	if err := s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	// If replication is empty then delete it.
 | 
						|
	if cfg.Empty() {
 | 
						|
		return c.removeBucketReplication(ctx, bucketName)
 | 
						|
	}
 | 
						|
	// Save the updated replication.
 | 
						|
	return c.putBucketReplication(ctx, bucketName, cfg)
 | 
						|
}
 | 
						|
 | 
						|
// Saves a new bucket replication.
 | 
						|
func (c *Client) putBucketReplication(ctx context.Context, bucketName string, cfg replication.Config) error {
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication", "")
 | 
						|
	replication, err := xml.Marshal(cfg)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	reqMetadata := requestMetadata{
 | 
						|
		bucketName:       bucketName,
 | 
						|
		queryValues:      urlValues,
 | 
						|
		contentBody:      bytes.NewReader(replication),
 | 
						|
		contentLength:    int64(len(replication)),
 | 
						|
		contentMD5Base64: sumMD5Base64(replication),
 | 
						|
	}
 | 
						|
 | 
						|
	// Execute PUT to upload a new bucket replication config.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodPut, reqMetadata)
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// Remove replication from a bucket.
 | 
						|
func (c *Client) removeBucketReplication(ctx context.Context, bucketName string) error {
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication", "")
 | 
						|
 | 
						|
	// Execute DELETE on objectName.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodDelete, requestMetadata{
 | 
						|
		bucketName:       bucketName,
 | 
						|
		queryValues:      urlValues,
 | 
						|
		contentSHA256Hex: emptySHA256Hex,
 | 
						|
	})
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
	return nil
 | 
						|
}
 | 
						|
 | 
						|
// GetBucketReplication fetches bucket replication configuration.If config is not
 | 
						|
// found, returns empty config with nil error.
 | 
						|
func (c *Client) GetBucketReplication(ctx context.Context, bucketName string) (cfg replication.Config, err error) {
 | 
						|
	// Input validation.
 | 
						|
	if err := s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return cfg, err
 | 
						|
	}
 | 
						|
	bucketReplicationCfg, err := c.getBucketReplication(ctx, bucketName)
 | 
						|
	if err != nil {
 | 
						|
		errResponse := ToErrorResponse(err)
 | 
						|
		if errResponse.Code == "ReplicationConfigurationNotFoundError" {
 | 
						|
			return cfg, nil
 | 
						|
		}
 | 
						|
		return cfg, err
 | 
						|
	}
 | 
						|
	return bucketReplicationCfg, nil
 | 
						|
}
 | 
						|
 | 
						|
// Request server for current bucket replication config.
 | 
						|
func (c *Client) getBucketReplication(ctx context.Context, bucketName string) (cfg replication.Config, err error) {
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication", "")
 | 
						|
 | 
						|
	// Execute GET on bucket to get replication config.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodGet, requestMetadata{
 | 
						|
		bucketName:  bucketName,
 | 
						|
		queryValues: urlValues,
 | 
						|
	})
 | 
						|
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return cfg, err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return cfg, httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
 | 
						|
	if err = xmlDecoder(resp.Body, &cfg); err != nil {
 | 
						|
		return cfg, err
 | 
						|
	}
 | 
						|
 | 
						|
	return cfg, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetBucketReplicationMetrics fetches bucket replication status metrics
 | 
						|
func (c *Client) GetBucketReplicationMetrics(ctx context.Context, bucketName string) (s replication.Metrics, err error) {
 | 
						|
	// Input validation.
 | 
						|
	if err := s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication-metrics", "")
 | 
						|
 | 
						|
	// Execute GET on bucket to get replication config.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodGet, requestMetadata{
 | 
						|
		bucketName:  bucketName,
 | 
						|
		queryValues: urlValues,
 | 
						|
	})
 | 
						|
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return s, httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
	respBytes, err := io.ReadAll(resp.Body)
 | 
						|
	if err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
 | 
						|
	if err := json.Unmarshal(respBytes, &s); err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
	return s, nil
 | 
						|
}
 | 
						|
 | 
						|
// mustGetUUID - get a random UUID.
 | 
						|
func mustGetUUID() string {
 | 
						|
	u, err := uuid.NewRandom()
 | 
						|
	if err != nil {
 | 
						|
		return ""
 | 
						|
	}
 | 
						|
	return u.String()
 | 
						|
}
 | 
						|
 | 
						|
// ResetBucketReplication kicks off replication of previously replicated objects if ExistingObjectReplication
 | 
						|
// is enabled in the replication config
 | 
						|
func (c *Client) ResetBucketReplication(ctx context.Context, bucketName string, olderThan time.Duration) (rID string, err error) {
 | 
						|
	rID = mustGetUUID()
 | 
						|
	_, err = c.resetBucketReplicationOnTarget(ctx, bucketName, olderThan, "", rID)
 | 
						|
	if err != nil {
 | 
						|
		return rID, err
 | 
						|
	}
 | 
						|
	return rID, nil
 | 
						|
}
 | 
						|
 | 
						|
// ResetBucketReplicationOnTarget kicks off replication of previously replicated objects if
 | 
						|
// ExistingObjectReplication is enabled in the replication config
 | 
						|
func (c *Client) ResetBucketReplicationOnTarget(ctx context.Context, bucketName string, olderThan time.Duration, tgtArn string) (replication.ResyncTargetsInfo, error) {
 | 
						|
	return c.resetBucketReplicationOnTarget(ctx, bucketName, olderThan, tgtArn, mustGetUUID())
 | 
						|
}
 | 
						|
 | 
						|
// ResetBucketReplication kicks off replication of previously replicated objects if ExistingObjectReplication
 | 
						|
// is enabled in the replication config
 | 
						|
func (c *Client) resetBucketReplicationOnTarget(ctx context.Context, bucketName string, olderThan time.Duration, tgtArn, resetID string) (rinfo replication.ResyncTargetsInfo, err error) {
 | 
						|
	// Input validation.
 | 
						|
	if err = s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return
 | 
						|
	}
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication-reset", "")
 | 
						|
	if olderThan > 0 {
 | 
						|
		urlValues.Set("older-than", olderThan.String())
 | 
						|
	}
 | 
						|
	if tgtArn != "" {
 | 
						|
		urlValues.Set("arn", tgtArn)
 | 
						|
	}
 | 
						|
	urlValues.Set("reset-id", resetID)
 | 
						|
	// Execute GET on bucket to get replication config.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodPut, requestMetadata{
 | 
						|
		bucketName:  bucketName,
 | 
						|
		queryValues: urlValues,
 | 
						|
	})
 | 
						|
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return rinfo, err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return rinfo, httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
 | 
						|
	if err = json.NewDecoder(resp.Body).Decode(&rinfo); err != nil {
 | 
						|
		return rinfo, err
 | 
						|
	}
 | 
						|
	return rinfo, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetBucketReplicationResyncStatus gets the status of replication resync
 | 
						|
func (c *Client) GetBucketReplicationResyncStatus(ctx context.Context, bucketName, arn string) (rinfo replication.ResyncTargetsInfo, err error) {
 | 
						|
	// Input validation.
 | 
						|
	if err := s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return rinfo, err
 | 
						|
	}
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication-reset-status", "")
 | 
						|
	if arn != "" {
 | 
						|
		urlValues.Set("arn", arn)
 | 
						|
	}
 | 
						|
	// Execute GET on bucket to get replication config.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodGet, requestMetadata{
 | 
						|
		bucketName:  bucketName,
 | 
						|
		queryValues: urlValues,
 | 
						|
	})
 | 
						|
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return rinfo, err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return rinfo, httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
 | 
						|
	if err = json.NewDecoder(resp.Body).Decode(&rinfo); err != nil {
 | 
						|
		return rinfo, err
 | 
						|
	}
 | 
						|
	return rinfo, nil
 | 
						|
}
 | 
						|
 | 
						|
// GetBucketReplicationMetricsV2 fetches bucket replication status metrics
 | 
						|
func (c *Client) GetBucketReplicationMetricsV2(ctx context.Context, bucketName string) (s replication.MetricsV2, err error) {
 | 
						|
	// Input validation.
 | 
						|
	if err := s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication-metrics", "2")
 | 
						|
 | 
						|
	// Execute GET on bucket to get replication metrics.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodGet, requestMetadata{
 | 
						|
		bucketName:  bucketName,
 | 
						|
		queryValues: urlValues,
 | 
						|
	})
 | 
						|
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return s, httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
	respBytes, err := io.ReadAll(resp.Body)
 | 
						|
	if err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
 | 
						|
	if err := json.Unmarshal(respBytes, &s); err != nil {
 | 
						|
		return s, err
 | 
						|
	}
 | 
						|
	return s, nil
 | 
						|
}
 | 
						|
 | 
						|
// CheckBucketReplication validates if replication is set up properly for a bucket
 | 
						|
func (c *Client) CheckBucketReplication(ctx context.Context, bucketName string) (err error) {
 | 
						|
	// Input validation.
 | 
						|
	if err := s3utils.CheckValidBucketName(bucketName); err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
	// Get resources properly escaped and lined up before
 | 
						|
	// using them in http request.
 | 
						|
	urlValues := make(url.Values)
 | 
						|
	urlValues.Set("replication-check", "")
 | 
						|
 | 
						|
	// Execute GET on bucket to get replication config.
 | 
						|
	resp, err := c.executeMethod(ctx, http.MethodGet, requestMetadata{
 | 
						|
		bucketName:  bucketName,
 | 
						|
		queryValues: urlValues,
 | 
						|
	})
 | 
						|
 | 
						|
	defer closeResponse(resp)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	if resp.StatusCode != http.StatusOK {
 | 
						|
		return httpRespToErrorResponse(resp, bucketName, "")
 | 
						|
	}
 | 
						|
	return nil
 | 
						|
}
 |