debian-mirror-gitlab/workhorse-vendor/gocloud.dev
2023-01-13 15:02:22 +05:30
..
aws New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
azure New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
blob New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
docstore New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
gcerrors New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
gcp New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
internal New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
mysql New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
postgres New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
pubsub New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
runtimevar New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
samples New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
secrets New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
server New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
wire New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
allmodules New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
AUTHORS New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
CODE_OF_CONDUCT.md New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
CONTRIBUTING.md New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
CONTRIBUTORS New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
doc.go New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
go.mod New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
go.sum New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
gocloud.code-workspace New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
LICENSE New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30
README.md New upstream version 15.6.4+ds1 2023-01-13 15:02:22 +05:30

The Go Cloud Development Kit (Go CDK)

Write once, run on any cloud ☁️

Build Status Go Report Card PkgGoDev Coverage GitHub go.mod Go version License

The Go Cloud Development Kit (Go CDK) allows Go application developers to seamlessly deploy cloud applications on any combination of cloud providers. It does this by providing stable, idiomatic interfaces for common uses like storage and databases. Think database/sql for cloud products.

Imagine writing this to read from blob storage (like Google Cloud Storage or S3):

ctx := context.Background()
bucket, err := blob.OpenBucket(ctx, "s3://my-bucket")
if err != nil {
    return err
}
defer bucket.Close()
blobReader, err := bucket.NewReader(ctx, "my-blob", nil)
if err != nil {
    return err
}

and being able to run that code on any cloud you want, avoiding all the ceremony of cloud-specific authorization, tracing, SDKs and all the other code required to make an application portable across cloud platforms.

The project works well with a code generator called Wire. It creates human-readable code that only imports the cloud SDKs for services you use. This allows the Go CDK to grow to support any number of cloud services, without increasing compile times or binary sizes, and avoiding any side effects from init() functions.

You can learn more about the project from our announcement blog post, or our talk at Next 2018:

Video: Building Go Applications for the Open Cloud (Cloud Next '18)

Installation

# First "cd" into your project directory if you have one to ensure "go get" uses
# Go modules (or not) appropriately. See "go help modules" for more info.
go get gocloud.dev

The Go CDK builds at the latest stable release of Go. Previous Go versions may compile but are not supported.

Documentation

Documentation for the project lives primarily on https://gocloud.dev/, including tutorials.

You can also browse Go package reference on pkg.go.dev.

Project status

The APIs are still in alpha, but we think they are production-ready and are actively looking for feedback from early adopters. If you have comments or questions please open an issue.

At this time we prefer to focus on maintaining the existing APIs and drivers, and are unlikely to accept new ones into the go-cloud repository. The modular nature of the Go CDK makes it simple to host new APIs and drivers for existing APIs externally, in separate repositories.

If you have a new API or driver that you believe are important and mature enough to be included, feel free to open an issue to discuss this; our default will likely be to suggest starting in a separate repository. We'll also be happy to maintain a list of such external APIs and drivers in this README.

Current features

The Go CDK provides generic APIs for:

  • Unstructured binary (blob) storage
  • Publish/Subscribe (pubsub)
  • Variables that change at runtime (runtimevar)
  • Connecting to MySQL and PostgreSQL databases (mysql, postgres)
  • Server startup and diagnostics: request logging, tracing, and health checking (server)

Contributing

Thank you for your interest in contributing to the Go Cloud Development Kit! ❤️

Everyone is welcome to contribute, whether it's in the form of code, documentation, bug reports, feature requests, or anything else. We encourage you to experiment with the Go CDK and make contributions to help evolve it to meet your needs!

The GitHub repository at google/go-cloud contains some driver implementations for each portable API. We intend to include Google Cloud Platform, Amazon Web Services, and Azure implementations, as well as prominent open source services and at least one implementation suitable for use in local testing. Unfortunately, we cannot support every service directly from the project; however, we encourage contributions in separate repositories.

If you create a repository that implements the Go CDK interfaces for other services, let us know! We would be happy to link to it here and give you a heads-up before making any breaking changes.

See the contributing guide for more details.

Community

This project is covered by the Go Code of Conduct.

The Go CDK is open-source and released under an Apache 2.0 License. Copyright © 20182019 The Go Cloud Development Kit Authors.

If you are looking for the website of GoCloud Systems, which is unrelated to the Go CDK, visit https://gocloud.systems.