mirror of
https://github.com/minio/minio.git
synced 2024-12-24 06:05:55 -05:00
450 lines
12 KiB
Go
450 lines
12 KiB
Go
/*
|
||
* Minio Cloud Storage, (C) 2017 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 cmd
|
||
|
||
import (
|
||
"errors"
|
||
"fmt"
|
||
"net/url"
|
||
"os"
|
||
"runtime"
|
||
"strings"
|
||
|
||
"github.com/gorilla/mux"
|
||
"github.com/minio/cli"
|
||
)
|
||
|
||
const azureGatewayTemplate = `NAME:
|
||
{{.HelpName}} - {{.Usage}}
|
||
|
||
USAGE:
|
||
{{.HelpName}} {{if .VisibleFlags}}[FLAGS]{{end}} [ENDPOINT]
|
||
{{if .VisibleFlags}}
|
||
FLAGS:
|
||
{{range .VisibleFlags}}{{.}}
|
||
{{end}}{{end}}
|
||
ENDPOINT:
|
||
Azure server endpoint. Default ENDPOINT is https://core.windows.net
|
||
|
||
ENVIRONMENT VARIABLES:
|
||
ACCESS:
|
||
MINIO_ACCESS_KEY: Username or access key of Azure storage.
|
||
MINIO_SECRET_KEY: Password or secret key of Azure storage.
|
||
|
||
BROWSER:
|
||
MINIO_BROWSER: To disable web browser access, set this value to "off".
|
||
|
||
EXAMPLES:
|
||
1. Start minio gateway server for Azure Blob Storage backend.
|
||
$ export MINIO_ACCESS_KEY=azureaccountname
|
||
$ export MINIO_SECRET_KEY=azureaccountkey
|
||
$ {{.HelpName}}
|
||
|
||
2. Start minio gateway server for Azure Blob Storage backend on custom endpoint.
|
||
$ export MINIO_ACCESS_KEY=azureaccountname
|
||
$ export MINIO_SECRET_KEY=azureaccountkey
|
||
$ {{.HelpName}} https://azure.example.com
|
||
`
|
||
|
||
var azureBackendCmd = cli.Command{
|
||
Name: "azure",
|
||
Usage: "Microsoft Azure Blob Storage.",
|
||
Action: azureGatewayMain,
|
||
CustomHelpTemplate: azureGatewayTemplate,
|
||
Flags: append(serverFlags,
|
||
cli.BoolFlag{
|
||
Name: "quiet",
|
||
Usage: "Disable startup banner.",
|
||
},
|
||
),
|
||
HideHelpCommand: true,
|
||
}
|
||
|
||
const s3GatewayTemplate = `NAME:
|
||
{{.HelpName}} - {{.Usage}}
|
||
|
||
USAGE:
|
||
{{.HelpName}} {{if .VisibleFlags}}[FLAGS]{{end}} [ENDPOINT]
|
||
{{if .VisibleFlags}}
|
||
FLAGS:
|
||
{{range .VisibleFlags}}{{.}}
|
||
{{end}}{{end}}
|
||
ENDPOINT:
|
||
S3 server endpoint. Default ENDPOINT is https://s3.amazonaws.com
|
||
|
||
ENVIRONMENT VARIABLES:
|
||
ACCESS:
|
||
MINIO_ACCESS_KEY: Username or access key of S3 storage.
|
||
MINIO_SECRET_KEY: Password or secret key of S3 storage.
|
||
|
||
BROWSER:
|
||
MINIO_BROWSER: To disable web browser access, set this value to "off".
|
||
|
||
EXAMPLES:
|
||
1. Start minio gateway server for AWS S3 backend.
|
||
$ export MINIO_ACCESS_KEY=accesskey
|
||
$ export MINIO_SECRET_KEY=secretkey
|
||
$ {{.HelpName}}
|
||
|
||
2. Start minio gateway server for S3 backend on custom endpoint.
|
||
$ export MINIO_ACCESS_KEY=Q3AM3UQ867SPQQA43P2F
|
||
$ export MINIO_SECRET_KEY=zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG
|
||
$ {{.HelpName}} https://play.minio.io:9000
|
||
`
|
||
|
||
const gcsGatewayTemplate = `NAME:
|
||
{{.HelpName}} - {{.Usage}}
|
||
|
||
USAGE:
|
||
{{.HelpName}} {{if .VisibleFlags}}[FLAGS]{{end}} PROJECTID
|
||
{{if .VisibleFlags}}
|
||
FLAGS:
|
||
{{range .VisibleFlags}}{{.}}
|
||
{{end}}{{end}}
|
||
PROJECTID:
|
||
GCS project id, there are no defaults this is mandatory.
|
||
|
||
ENVIRONMENT VARIABLES:
|
||
ACCESS:
|
||
MINIO_ACCESS_KEY: Username or access key of S3 storage.
|
||
MINIO_SECRET_KEY: Password or secret key of S3 storage.
|
||
|
||
BROWSER:
|
||
MINIO_BROWSER: To disable web browser access, set this value to "off".
|
||
|
||
EXAMPLES:
|
||
1. Start minio gateway server for AWS S3 backend.
|
||
$ export MINIO_ACCESS_KEY=accesskey
|
||
$ export MINIO_SECRET_KEY=secretkey
|
||
$ {{.HelpName}} minio-kubernetes-gcs
|
||
`
|
||
|
||
var s3BackendCmd = cli.Command{
|
||
Name: "s3",
|
||
Usage: "Amazon Simple Storage Service (S3).",
|
||
Action: s3GatewayMain,
|
||
CustomHelpTemplate: s3GatewayTemplate,
|
||
Flags: append(serverFlags,
|
||
cli.BoolFlag{
|
||
Name: "quiet",
|
||
Usage: "Disable startup banner.",
|
||
},
|
||
),
|
||
HideHelpCommand: true,
|
||
}
|
||
|
||
var gcsBackendCmd = cli.Command{
|
||
Name: "gcs",
|
||
Usage: "Google Cloud Storage.",
|
||
Action: gcsGatewayMain,
|
||
CustomHelpTemplate: gcsGatewayTemplate,
|
||
Flags: append(serverFlags,
|
||
cli.BoolFlag{
|
||
Name: "quiet",
|
||
Usage: "Disable startup banner.",
|
||
},
|
||
),
|
||
HideHelpCommand: true,
|
||
}
|
||
|
||
var gatewayCmd = cli.Command{
|
||
Name: "gateway",
|
||
Usage: "Start object storage gateway.",
|
||
HideHelpCommand: true,
|
||
Subcommands: []cli.Command{azureBackendCmd, s3BackendCmd, gcsBackendCmd},
|
||
}
|
||
|
||
// Represents the type of the gateway backend.
|
||
type gatewayBackend string
|
||
|
||
const (
|
||
azureBackend gatewayBackend = "azure"
|
||
s3Backend gatewayBackend = "s3"
|
||
gcsBackend gatewayBackend = "gcs"
|
||
// Add more backends here.
|
||
)
|
||
|
||
// Returns access and secretkey set from environment variables.
|
||
func mustGetGatewayConfigFromEnv() (string, string, string) {
|
||
// Fetch access keys from environment variables.
|
||
accessKey := os.Getenv("MINIO_ACCESS_KEY")
|
||
secretKey := os.Getenv("MINIO_SECRET_KEY")
|
||
if accessKey == "" || secretKey == "" {
|
||
fatalIf(errors.New("Missing credentials"), "Access and secret keys are mandatory to run Minio gateway server.")
|
||
}
|
||
|
||
region := globalMinioDefaultRegion
|
||
if v := os.Getenv("MINIO_REGION"); v != "" {
|
||
region = v
|
||
}
|
||
|
||
return accessKey, secretKey, region
|
||
}
|
||
|
||
// Set browser setting from environment variables
|
||
func mustSetBrowserSettingFromEnv() {
|
||
if browser := os.Getenv("MINIO_BROWSER"); browser != "" {
|
||
browserFlag, err := ParseBrowserFlag(browser)
|
||
if err != nil {
|
||
fatalIf(errors.New("invalid value"), "Unknown value ‘%s’ in MINIO_BROWSER environment variable.", browser)
|
||
}
|
||
|
||
// browser Envs are set globally, this does not represent
|
||
// if browser is turned off or on.
|
||
globalIsEnvBrowser = true
|
||
globalIsBrowserEnabled = bool(browserFlag)
|
||
}
|
||
}
|
||
|
||
// Initialize gateway layer depending on the backend type.
|
||
// Supported backend types are
|
||
//
|
||
// - Azure Blob Storage.
|
||
// - AWS S3.
|
||
// - Google Cloud Storage.
|
||
// - Add your favorite backend here.
|
||
func newGatewayLayer(backendType string, args cli.Args) (GatewayLayer, error) {
|
||
switch gatewayBackend(backendType) {
|
||
case azureBackend:
|
||
return newAzureLayer(args)
|
||
case s3Backend:
|
||
return newS3Gateway(args)
|
||
case gcsBackend:
|
||
return newGCSGateway(args)
|
||
}
|
||
|
||
return nil, fmt.Errorf("Unrecognized backend type %s", backendType)
|
||
}
|
||
|
||
// Initialize a new gateway config.
|
||
//
|
||
// DO NOT save this config, this is meant to be
|
||
// only used in memory.
|
||
func newGatewayConfig(accessKey, secretKey, region string) error {
|
||
// Initialize server config.
|
||
srvCfg := newServerConfigV19()
|
||
|
||
// If env is set for a fresh start, save them to config file.
|
||
srvCfg.SetCredential(credential{
|
||
AccessKey: accessKey,
|
||
SecretKey: secretKey,
|
||
})
|
||
|
||
// Set custom region.
|
||
srvCfg.SetRegion(region)
|
||
|
||
// hold the mutex lock before a new config is assigned.
|
||
// Save the new config globally.
|
||
// unlock the mutex.
|
||
serverConfigMu.Lock()
|
||
serverConfig = srvCfg
|
||
serverConfigMu.Unlock()
|
||
|
||
return nil
|
||
}
|
||
|
||
// Return endpoint.
|
||
func parseGatewayEndpoint(arg string) (endPoint string, secure bool, err error) {
|
||
schemeSpecified := len(strings.Split(arg, "://")) > 1
|
||
if !schemeSpecified {
|
||
// Default connection will be "secure".
|
||
arg = "https://" + arg
|
||
}
|
||
|
||
u, err := url.Parse(arg)
|
||
if err != nil {
|
||
return "", false, err
|
||
}
|
||
|
||
switch u.Scheme {
|
||
case "http":
|
||
return u.Host, false, nil
|
||
case "https":
|
||
return u.Host, true, nil
|
||
default:
|
||
return "", false, fmt.Errorf("Unrecognized scheme %s", u.Scheme)
|
||
}
|
||
}
|
||
|
||
// Validate gateway arguments.
|
||
func validateGatewayArguments(serverAddr, endpointAddr string) error {
|
||
if err := CheckLocalServerAddr(serverAddr); err != nil {
|
||
return err
|
||
}
|
||
|
||
if runtime.GOOS == "darwin" {
|
||
_, port := mustSplitHostPort(serverAddr)
|
||
// On macOS, if a process already listens on LOCALIPADDR:PORT, net.Listen() falls back
|
||
// to IPv6 address i.e minio will start listening on IPv6 address whereas another
|
||
// (non-)minio process is listening on IPv4 of given port.
|
||
// To avoid this error situation we check for port availability only for macOS.
|
||
if err := checkPortAvailability(port); err != nil {
|
||
return err
|
||
}
|
||
}
|
||
|
||
if endpointAddr != "" {
|
||
// Reject the endpoint if it points to the gateway handler itself.
|
||
sameTarget, err := sameLocalAddrs(endpointAddr, serverAddr)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
if sameTarget {
|
||
return errors.New("endpoint points to the local gateway")
|
||
}
|
||
}
|
||
return nil
|
||
}
|
||
|
||
// Handler for 'minio gateway azure' command line.
|
||
func azureGatewayMain(ctx *cli.Context) {
|
||
if ctx.Args().Present() && ctx.Args().First() == "help" {
|
||
cli.ShowCommandHelpAndExit(ctx, "azure", 1)
|
||
}
|
||
|
||
gatewayMain(ctx, azureBackend)
|
||
}
|
||
|
||
// Handler for 'minio gateway s3' command line.
|
||
func s3GatewayMain(ctx *cli.Context) {
|
||
if ctx.Args().Present() && ctx.Args().First() == "help" {
|
||
cli.ShowCommandHelpAndExit(ctx, "s3", 1)
|
||
}
|
||
|
||
gatewayMain(ctx, s3Backend)
|
||
}
|
||
|
||
// Handler for 'minio gateway gcs' command line
|
||
func gcsGatewayMain(ctx *cli.Context) {
|
||
if ctx.Args().Present() && ctx.Args().First() == "help" {
|
||
cli.ShowCommandHelpAndExit(ctx, "s3", 1)
|
||
}
|
||
|
||
gatewayMain(ctx, gcsBackend)
|
||
}
|
||
|
||
// Handler for 'minio gateway'.
|
||
func gatewayMain(ctx *cli.Context, backendType gatewayBackend) {
|
||
// Fetch access and secret key from env.
|
||
accessKey, secretKey, region := mustGetGatewayConfigFromEnv()
|
||
|
||
// Fetch browser env setting
|
||
mustSetBrowserSettingFromEnv()
|
||
|
||
// Initialize new gateway config.
|
||
newGatewayConfig(accessKey, secretKey, region)
|
||
|
||
// Get quiet flag from command line argument.
|
||
quietFlag := ctx.Bool("quiet") || ctx.GlobalBool("quiet")
|
||
if quietFlag {
|
||
log.EnableQuiet()
|
||
}
|
||
|
||
serverAddr := ctx.String("address")
|
||
endpointAddr := ctx.Args().First()
|
||
err := validateGatewayArguments(serverAddr, endpointAddr)
|
||
fatalIf(err, "Invalid argument")
|
||
|
||
// Create certs path for SSL configuration.
|
||
fatalIf(createConfigDir(), "Unable to create configuration directory")
|
||
|
||
initNSLock(false) // Enable local namespace lock.
|
||
|
||
newObject, err := newGatewayLayer(backendType, ctx.Args()[1:])
|
||
fatalIf(err, "Unable to initialize gateway layer")
|
||
|
||
router := mux.NewRouter().SkipClean(true)
|
||
|
||
// credentials Envs are set globally.
|
||
globalIsEnvCreds = true
|
||
|
||
// Register web router when its enabled.
|
||
if globalIsBrowserEnabled {
|
||
aerr := registerWebRouter(router)
|
||
fatalIf(aerr, "Unable to configure web browser")
|
||
}
|
||
registerGatewayAPIRouter(router, newObject)
|
||
|
||
var handlerFns = []HandlerFunc{
|
||
// Validate all the incoming paths.
|
||
setPathValidityHandler,
|
||
// Limits all requests size to a maximum fixed limit
|
||
setRequestSizeLimitHandler,
|
||
// Adds 'crossdomain.xml' policy handler to serve legacy flash clients.
|
||
setCrossDomainPolicy,
|
||
// Validates all incoming requests to have a valid date header.
|
||
// Redirect some pre-defined browser request paths to a static location prefix.
|
||
setBrowserRedirectHandler,
|
||
// Validates if incoming request is for restricted buckets.
|
||
setPrivateBucketHandler,
|
||
// Adds cache control for all browser requests.
|
||
setBrowserCacheControlHandler,
|
||
// Validates all incoming requests to have a valid date header.
|
||
setTimeValidityHandler,
|
||
// CORS setting for all browser API requests.
|
||
setCorsHandler,
|
||
// Validates all incoming URL resources, for invalid/unsupported
|
||
// resources client receives a HTTP error.
|
||
setIgnoreResourcesHandler,
|
||
// Auth handler verifies incoming authorization headers and
|
||
// routes them accordingly. Client receives a HTTP error for
|
||
// invalid/unsupported signatures.
|
||
setAuthHandler,
|
||
// Add new handlers here.
|
||
|
||
}
|
||
|
||
apiServer := NewServerMux(serverAddr, registerHandlers(router, handlerFns...))
|
||
|
||
_, _, globalIsSSL, err = getSSLConfig()
|
||
fatalIf(err, "Invalid SSL key file")
|
||
|
||
// Start server, automatically configures TLS if certs are available.
|
||
go func() {
|
||
cert, key := "", ""
|
||
if globalIsSSL {
|
||
cert, key = getPublicCertFile(), getPrivateKeyFile()
|
||
}
|
||
|
||
aerr := apiServer.ListenAndServe(cert, key)
|
||
fatalIf(aerr, "Failed to start minio server")
|
||
}()
|
||
|
||
// Once endpoints are finalized, initialize the new object api.
|
||
globalObjLayerMutex.Lock()
|
||
globalObjectAPI = newObject
|
||
globalObjLayerMutex.Unlock()
|
||
|
||
// Prints the formatted startup message once object layer is initialized.
|
||
if !quietFlag {
|
||
mode := ""
|
||
switch gatewayBackend(backendType) {
|
||
case azureBackend:
|
||
mode = globalMinioModeGatewayAzure
|
||
case gcsBackend:
|
||
mode = globalMinioModeGatewayGCS
|
||
case s3Backend:
|
||
mode = globalMinioModeGatewayS3
|
||
}
|
||
checkUpdate(mode)
|
||
apiEndpoints := getAPIEndpoints(apiServer.Addr)
|
||
printGatewayStartupMessage(apiEndpoints, accessKey, secretKey, backendType)
|
||
}
|
||
|
||
<-globalServiceDoneCh
|
||
}
|