使用Vultr Go客户端创建Vultr对象存储

• 介绍
• 先决条件
• 使用Vultr Go客户端创建对象存储
• 创建项目文件夹
• 初始化模块
• 下载资料库
• 设置API密钥环境变量
• 创建执行程序
• 示例输出

介绍

本指南介绍了如何使用Vultr Go客户端在Go应用程序中创建Vultr对象存储。Vultr对象存储与S3 API兼容。

先决条件

• 运行Windows，Linux或macOS且安装了Go 1.12+的计算机。
• 基本的编程知识。
• 可选：支持Go的IDE（例如Visual Studio Code，emacs或Atom）。

使用Vultr Go客户端创建对象存储

该Vultr围棋客户端用来与互动Vultr API。通过Vultr API，您可以控制与帐户相关联的资源，包括Vultr对象存储。在Vultr围棋客户端上的详细信息中可以找到 这篇文章。

创建项目文件夹

在当前目录中创建文件夹。

$ mkdir vultr_demo

输入新文件夹。

$ cd vultr_demo

初始化模块

$ go mod init vultr_demo

下载资料库

$ go get github.com/vultr/govultr

设置API密钥环境变量

将VULTR_API_KEY环境变量设置为您的API密钥。您的API密钥位于以下位置：https : //my.vultr.com/settings/#settingsapi

警告：保护API密钥就像保护密码一样。API密钥可以访问您的整个帐户，包括帐单，服务器和存储。

例如，在Ubuntu Linux上，将此行添加到~/.profile。

export VULTR_API_KEY=YOUR_API_KEY_HERE

创建执行程序

将以下每个代码片段粘贴到名为的新文件中main.go。 完整的文件也可以下载。

设置程序包并导入所需的库。

package main

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

    "github.com/vultr/govultr"
)

开始main()功能。

func main() {

阅读API密钥环境变量。

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

创建Vultr客户端。

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

指定创建对象存储的位置。检索群集位置，确认其中一个可用，选择一个群集并显示它。

// 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)

在所选集群中创建对象存储。

// 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)

等待对象存储处于活动状态。

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)
}

显示端点名称和连接凭证。

// 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)

结束主要功能。

// end main()
}

保存并运行完成的main.go文件。

go run main.go

示例输出

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]

在此示例中，端点名称为ewr1.vultrobjects.com，并且密钥已编辑。使用Go程序显示的端点名称，访问密钥和秘密密钥，通过任何与S3兼容的客户端访问新对象存储。