services/keepstore/command.go

   1 // Copyright (C) The Arvados Authors. All rights reserved.
   2 //
   3 // SPDX-License-Identifier: AGPL-3.0
   4
   5 package main
   6
   7 import (
   8         "context"
   9         "errors"
  10         "flag"
  11         "fmt"
  12         "io"
  13         "math/rand"
  14         "net/http"
  15         "os"
  16         "sync"
  17
  18         "git.arvados.org/arvados.git/lib/config"
  19         "git.arvados.org/arvados.git/lib/service"
  20         "git.arvados.org/arvados.git/sdk/go/arvados"
  21         "git.arvados.org/arvados.git/sdk/go/arvadosclient"
  22         "git.arvados.org/arvados.git/sdk/go/ctxlog"
  23         "git.arvados.org/arvados.git/sdk/go/keepclient"
  24         "github.com/prometheus/client_golang/prometheus"
  25         "github.com/sirupsen/logrus"
  26 )
  27
  28 var (
  29         version = "dev"
  30         Command = service.Command(arvados.ServiceNameKeepstore, newHandlerOrErrorHandler)
  31 )
  32
  33 func main() {
  34         os.Exit(runCommand(os.Args[0], os.Args[1:], os.Stdin, os.Stdout, os.Stderr))
  35 }
  36
  37 func runCommand(prog string, args []string, stdin io.Reader, stdout, stderr io.Writer) int {
  38         args, ok := convertKeepstoreFlagsToServiceFlags(args, ctxlog.FromContext(context.Background()))
  39         if !ok {
  40                 return 2
  41         }
  42         return Command.RunCommand(prog, args, stdin, stdout, stderr)
  43 }
  44
  45 // Parse keepstore command line flags, and return equivalent
  46 // service.Command flags. The second return value ("ok") is true if
  47 // all provided flags were successfully converted.
  48 func convertKeepstoreFlagsToServiceFlags(args []string, lgr logrus.FieldLogger) ([]string, bool) {
  49         flags := flag.NewFlagSet("", flag.ContinueOnError)
  50         flags.String("listen", "", "Services.Keepstore.InternalURLs")
  51         flags.Int("max-buffers", 0, "API.MaxKeepBlobBuffers")
  52         flags.Int("max-requests", 0, "API.MaxConcurrentRequests")
  53         flags.Bool("never-delete", false, "Collections.BlobTrash")
  54         flags.Bool("enforce-permissions", false, "Collections.BlobSigning")
  55         flags.String("permission-key-file", "", "Collections.BlobSigningKey")
  56         flags.String("blob-signing-key-file", "", "Collections.BlobSigningKey")
  57         flags.String("data-manager-token-file", "", "SystemRootToken")
  58         flags.Int("permission-ttl", 0, "Collections.BlobSigningTTL")
  59         flags.Int("blob-signature-ttl", 0, "Collections.BlobSigningTTL")
  60         flags.String("trash-lifetime", "", "Collections.BlobTrashLifetime")
  61         flags.Bool("serialize", false, "Volumes.*.DriverParameters.Serialize")
  62         flags.Bool("readonly", false, "Volumes.*.ReadOnly")
  63         flags.String("pid", "", "-")
  64         flags.String("trash-check-interval", "", "Collections.BlobTrashCheckInterval")
  65
  66         flags.String("azure-storage-container-volume", "", "Volumes.*.Driver")
  67         flags.String("azure-storage-account-name", "", "Volumes.*.DriverParameters.StorageAccountName")
  68         flags.String("azure-storage-account-key-file", "", "Volumes.*.DriverParameters.StorageAccountKey")
  69         flags.String("azure-storage-replication", "", "Volumes.*.Replication")
  70         flags.String("azure-max-get-bytes", "", "Volumes.*.DriverParameters.MaxDataReadSize")
  71
  72         flags.String("s3-bucket-volume", "", "Volumes.*.DriverParameters.Bucket")
  73         flags.String("s3-region", "", "Volumes.*.DriverParameters.Region")
  74         flags.String("s3-endpoint", "", "Volumes.*.DriverParameters.Endpoint")
  75         flags.String("s3-access-key-file", "", "Volumes.*.DriverParameters.AccessKey")
  76         flags.String("s3-secret-key-file", "", "Volumes.*.DriverParameters.SecretKey")
  77         flags.String("s3-race-window", "", "Volumes.*.DriverParameters.RaceWindow")
  78         flags.String("s3-replication", "", "Volumes.*.Replication")
  79         flags.String("s3-unsafe-delete", "", "Volumes.*.DriverParameters.UnsafeDelete")
  80
  81         flags.String("volume", "", "Volumes")
  82
  83         flags.Bool("version", false, "")
  84         flags.String("config", "", "")
  85         flags.String("legacy-keepstore-config", "", "")
  86
  87         err := flags.Parse(args)
  88         if err == flag.ErrHelp {
  89                 return []string{"-help"}, true
  90         } else if err != nil {
  91                 return nil, false
  92         }
  93
  94         args = nil
  95         ok := true
  96         flags.Visit(func(f *flag.Flag) {
  97                 if f.Name == "config" || f.Name == "legacy-keepstore-config" || f.Name == "version" {
  98                         args = append(args, "-"+f.Name, f.Value.String())
  99                 } else if f.Usage == "-" {
 100                         ok = false
 101                         lgr.Errorf("command line flag -%s is no longer supported", f.Name)
 102                 } else {
 103                         ok = false
 104                         lgr.Errorf("command line flag -%s is no longer supported -- use Clusters.*.%s in cluster config file instead", f.Name, f.Usage)
 105                 }
 106         })
 107         if !ok {
 108                 return nil, false
 109         }
 110
 111         flags = flag.NewFlagSet("", flag.ExitOnError)
 112         loader := config.NewLoader(nil, lgr)
 113         loader.SetupFlags(flags)
 114         return loader.MungeLegacyConfigArgs(lgr, args, "-legacy-keepstore-config"), true
 115 }
 116
 117 type handler struct {
 118         http.Handler
 119         Cluster *arvados.Cluster
 120         Logger  logrus.FieldLogger
 121
 122         pullq      *WorkQueue
 123         trashq     *WorkQueue
 124         volmgr     *RRVolumeManager
 125         keepClient *keepclient.KeepClient
 126
 127         err       error
 128         setupOnce sync.Once
 129 }
 130
 131 func (h *handler) CheckHealth() error {
 132         return h.err
 133 }
 134
 135 func (h *handler) Done() <-chan struct{} {
 136         return nil
 137 }
 138
 139 func newHandlerOrErrorHandler(ctx context.Context, cluster *arvados.Cluster, token string, reg *prometheus.Registry) service.Handler {
 140         var h handler
 141         serviceURL, ok := service.URLFromContext(ctx)
 142         if !ok {
 143                 return service.ErrorHandler(ctx, cluster, errors.New("BUG: no URL from service.URLFromContext"))
 144         }
 145         err := h.setup(ctx, cluster, token, reg, serviceURL)
 146         if err != nil {
 147                 return service.ErrorHandler(ctx, cluster, err)
 148         }
 149         return &h
 150 }
 151
 152 func (h *handler) setup(ctx context.Context, cluster *arvados.Cluster, token string, reg *prometheus.Registry, serviceURL arvados.URL) error {
 153         h.Cluster = cluster
 154         h.Logger = ctxlog.FromContext(ctx)
 155         if h.Cluster.API.MaxKeepBlobBuffers <= 0 {
 156                 return fmt.Errorf("API.MaxKeepBlobBuffers must be greater than zero")
 157         }
 158         bufs = newBufferPool(h.Logger, h.Cluster.API.MaxKeepBlobBuffers, BlockSize)
 159
 160         if h.Cluster.API.MaxConcurrentRequests > 0 && h.Cluster.API.MaxConcurrentRequests < h.Cluster.API.MaxKeepBlobBuffers {
 161                 h.Logger.Warnf("Possible configuration mistake: not useful to set API.MaxKeepBlobBuffers (%d) higher than API.MaxConcurrentRequests (%d)", h.Cluster.API.MaxKeepBlobBuffers, h.Cluster.API.MaxConcurrentRequests)
 162         }
 163
 164         if h.Cluster.Collections.BlobSigningKey != "" {
 165         } else if h.Cluster.Collections.BlobSigning {
 166                 return errors.New("cannot enable Collections.BlobSigning with no Collections.BlobSigningKey")
 167         } else {
 168                 h.Logger.Warn("Running without a blob signing key. Block locators returned by this server will not be signed, and will be rejected by a server that enforces permissions. To fix this, configure Collections.BlobSigning and Collections.BlobSigningKey.")
 169         }
 170
 171         if len(h.Cluster.Volumes) == 0 {
 172                 return errors.New("no volumes configured")
 173         }
 174
 175         h.Logger.Printf("keepstore %s starting, pid %d", version, os.Getpid())
 176
 177         // Start a round-robin VolumeManager with the configured volumes.
 178         vm, err := makeRRVolumeManager(h.Logger, h.Cluster, serviceURL, newVolumeMetricsVecs(reg))
 179         if err != nil {
 180                 return err
 181         }
 182         if len(vm.readables) == 0 {
 183                 return fmt.Errorf("no volumes configured for %s", serviceURL)
 184         }
 185         h.volmgr = vm
 186
 187         // Initialize the pullq and workers
 188         h.pullq = NewWorkQueue()
 189         for i := 0; i < 1 || i < h.Cluster.Collections.BlobReplicateConcurrency; i++ {
 190                 go h.runPullWorker(h.pullq)
 191         }
 192
 193         // Initialize the trashq and workers
 194         h.trashq = NewWorkQueue()
 195         for i := 0; i < 1 || i < h.Cluster.Collections.BlobTrashConcurrency; i++ {
 196                 go RunTrashWorker(h.volmgr, h.Logger, h.Cluster, h.trashq)
 197         }
 198
 199         // Set up routes and metrics
 200         h.Handler = MakeRESTRouter(ctx, cluster, reg, vm, h.pullq, h.trashq)
 201
 202         // Initialize keepclient for pull workers
 203         c, err := arvados.NewClientFromConfig(cluster)
 204         if err != nil {
 205                 return err
 206         }
 207         ac, err := arvadosclient.New(c)
 208         if err != nil {
 209                 return err
 210         }
 211         h.keepClient = &keepclient.KeepClient{
 212                 Arvados:       ac,
 213                 Want_replicas: 1,
 214         }
 215         h.keepClient.Arvados.ApiToken = fmt.Sprintf("%x", rand.Int63())
 216
 217         if d := h.Cluster.Collections.BlobTrashCheckInterval.Duration(); d > 0 {
 218                 go emptyTrash(h.volmgr.writables, d)
 219         }
 220
 221         return nil
 222 }