Að búa til Vultr Object Storage með Vultr Go viðskiptavininum

Kynning

Þessi handbók útskýrir hvernig á að búa til Vultr Object Storage í Go forritinu þínu með Vultr Go biðlaranum . Vultr Object Storage er samhæft við S3 API.

Forkröfur

• Tölva sem keyrir Windows, Linux eða macOS með Go 1.12+ uppsett.
• Grunnþekking á forritun.
• Valfrjálst: IDE sem styður Go (til dæmis Visual Studio Code, emacs eða Atom).

Að búa til hlutgeymslu með Vultr Go viðskiptavininum

The Vultr Go Viðskiptavinurinn er notað til að hafa samskipti við Vultr API . Vultr API gerir þér kleift að stjórna auðlindum sem tengjast reikningnum þínum, þar á meðal Vultr Object Storage. Ítarlegar upplýsingar um Vultr Go viðskiptavininn eru fáanlegar í þessari grein .

Búðu til verkefnamöppuna

Búðu til möppuna í núverandi möppu.

$ mkdir vultr_demo

Sláðu inn nýju möppuna.

$ cd vultr_demo

Frumstilla eininguna

$ go mod init vultr_demo

Sækja bókasafnið

$ go get github.com/vultr/govultr

Stilltu API Key Environment Variable

Stilltu VULTR_API_KEY umhverfisbreytuna á API lykilinn þinn. API lykillinn þinn er að finna hér: https://my.vultr.com/settings/#settingsapi

Viðvörun: Verndaðu API lykilinn þinn eins og þú myndir vernda lykilorðið þitt. API lykillinn hefur aðgang að öllum reikningnum þínum, þar á meðal innheimtu, netþjónum og geymslu.

Til dæmis, á Ubuntu Linux, bættu þessari línu við ~/.profile.

export VULTR_API_KEY=YOUR_API_KEY_HERE

Búðu til Go forritið

Límdu hvert af eftirfarandi kóðabrotum í nýja skrá sem heitir main.go. Einnig er hægt að hlaða niður heildarskránni .

Settu upp pakkann og fluttu inn nauðsynleg söfn.

package main

import (
    "context"
    "log"
    "os"
    "time"

    "github.com/vultr/govultr"
)

Byrjaðu main()aðgerðina.

func main() {

Lestu API lykilumhverfisbreytuna.

var (
    // Get our Vultr API Key from an environment variable.
    VultrAPIKey = os.Getenv("VULTR_API_KEY")
)

Búðu til Vultr viðskiptavininn.

// Create a Vultr client with our API Key.
vultr := govultr.NewClient(nil, VultrAPIKey)

Tilgreindu staðsetningu til að búa til Object Storage. Sæktu klasastaðsetningarnar, staðfestu að einn sé tiltækur, veldu klasa og sýndu hann.

// Find the clusters we can create our Object Storage in.
clusters, err := vultr.ObjectStorage.ListCluster(ctx)
if err != nil {
    log.Fatalf("Error listing clusters: %s", err)
}

// Verify there's at least one cluster.
if len(clusters) < 1 {
    log.Fatal("Could not find any clusters to create our Object Storage")
}

// Choose the first cluster, and print it.
cluster := clusters[0]
log.Printf("Chosen cluster: %+v", cluster)

Búðu til Hlutageymsluna í völdum klasa.

// Create our Object Storage in the first cluster listed with our custom label.
label := "my-object-storage"
storageID, err := vultr.ObjectStorage.Create(ctx, cluster.ObjectStoreClusterID, label)
if err != nil {
    log.Fatalf("Error creating storage: %s", err)
}

log.Printf("Created our Object Storage with the ID: %d", storageID.ID)

Bíddu þar til Object Storage er virk.

var storage govultr.ObjectStorage

// Query the API every five seconds to until our server is ready.
for {
    // List all of the Object Storage containers with our label and include the S3 credentials.
    list, err := vultr.ObjectStorage.List(ctx, &govultr.ObjectListOptions{
        Label:     label,
        IncludeS3: true,
    })
    if err != nil {
        log.Fatalf("Error listing storage with label \"%s\": %s", label, err)
    }

    // Make sure we found one (and only one) Object Storage container.
    if len(list) != 1 {
        log.Fatalf("%d object storage containers exist with the label \"%s\"; we need 1", len(list), label)
    }

    storage = list[0]

    // If the server is active, break out of this loop.
    if storage.Status == "active" {
        break
    }

    // Wait for five seconds before querying the API again.
    log.Printf("The Object Storage's status is currently \"%s\", waiting for another five seconds to check if it's \"active\".", storage.Status)
    time.Sleep(time.Second * 5)
}

Birta nafn endapunkts og tengingarskilríki.

// Print the information of our new Object Storage.
log.Print("Successfully created and listed our Object Storage!")
log.Printf("Object Storage: %+v", storage)

// We also have S3 credentials here now, so we could open an S3 compatible client.
log.Printf("S3 credentials: %s - %s - %s", storage.S3Hostname, storage.S3AccessKey, storage.S3SecretKey)

Ljúktu aðalaðgerðinni.

// end main()
}

Vistaðu og keyrðu lokið main.goskrána.

go run main.go

Dæmi úttak

2020/03/03 13:05:48 Chosen cluster: {ObjectStoreClusterID:2 RegionID:1 Location:New Jersey Hostname:ewr1.vultrobjects.com Deploy:yes}
2020/03/03 13:05:48 Created our Object Storage with the ID: xxxxxxxx
2020/03/03 13:05:49 The Object Storage's status is currently pending, waiting for another five seconds to check if it's active.
2020/03/03 13:06:06 Object Storage: {ID:34214512 DateCreated:2020-03-03 13:05:47 ObjectStoreClusterID:2 RegionID:1 Location:New Jersey Label:my-object-storage Status:active S3Keys:{S3Hostname:ewr1.vultrobjects.com S3AccessKey:[REDACTED ACCESS KEY] S3SecretKey:[REDACTED SECRET KEY]}}
2020/03/03 13:06:06 S3 credentials: ewr1.vultrobjects.com - [REDACTED ACCESS KEY] - [REDACTED SECRET KEY]

Í þessu dæmi er endapunktsheitið ewr1.vultrobjects.com og lyklarnir eru gerðir út. Fáðu aðgang að nýju hlutageymslunni þinni með hvaða S3 samhæfðum biðlara sem er með því að nota endapunktsnafnið, aðgangslykilinn og leynilykilinn sem Go forritið þitt sýnir.