gcore

package
v0.8.11 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 9, 2024 License: MPL-2.0 Imports: 7 Imported by: 0

Documentation

Overview

Package gcore contains resources for the individual projects. It also includes functions to authenticate to an Gcore cloud and for provisioning various service-level clients.

Example of Creating a Gcore Magnum Cluster Client 

ao, err := gcore.AuthOptionsFromEnv()
provider, err := gcore.AuthenticatedClient(ao)
client, err := gcore.MagnumClusterV1(client, gcorecloud.EndpointOpts{
})

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func APITokenClient added in v0.4.32 

func APITokenClient(options gcorecloud.APITokenOptions) (*gcorecloud.ProviderClient, error)

func APITokenClientServiceWithDebug added in v0.4.32 

func APITokenClientServiceWithDebug(options gcorecloud.APITokenOptions, eo gcorecloud.EndpointOpts, debug bool) (*gcorecloud.ServiceClient, error)

func APITokenClientWithDebug added in v0.4.32 

func APITokenClientWithDebug(options gcorecloud.APITokenOptions, debug bool) (*gcorecloud.ProviderClient, error)

func AuthClientService 

func AuthClientService(options gcorecloud.AuthOptions, eo gcorecloud.EndpointOpts) (*gcorecloud.ServiceClient, error)

func AuthClientServiceWithDebug 

func AuthClientServiceWithDebug(options gcorecloud.AuthOptions, eo gcorecloud.EndpointOpts, debug bool) (*gcorecloud.ServiceClient, error)

func AuthOptionsFromEnv 

func AuthOptionsFromEnv() (gcorecloud.AuthOptions, error)

AuthOptionsFromEnv fills out an identity.AuthOptions structure with the settings found on environment variables.

The following variables provide sources of truth: GCLOUD_USERNAME, GCLOUD_PASSWORD, GCLOUD_AUTH_URL 

opts, err := gcore.AuthOptionsFromEnv()
provider, err := gcore.AuthenticatedClient(opts)

func Authenticate 

func Authenticate(client *gcorecloud.ProviderClient, options gcorecloud.AuthOptions) error

Authenticate or re-authenticate against the most recent identity service supported at the provided endpoint.

func AuthenticatedClient 

func AuthenticatedClient(options gcorecloud.AuthOptions) (*gcorecloud.ProviderClient, error)

AuthenticatedClient logs in to an GCore cloud found at the identity endpoint specified by the options, acquires a token, and returns a Provider Client instance that's ready to operate.

Example: 

ao, err := gcore.AuthOptionsFromEnv()
provider, err := gcore.AuthenticatedClient(ao)
client, err := gcore.NewMagnumV1(provider, gcorecloud.EndpointOpts{})

func AuthenticatedClientWithDebug 

func AuthenticatedClientWithDebug(options gcorecloud.AuthOptions, debug bool) (*gcorecloud.ProviderClient, error)

func ClientServiceFromProvider 

func ClientServiceFromProvider(provider *gcorecloud.ProviderClient, eo gcorecloud.EndpointOpts) (*gcorecloud.ServiceClient, error)

func EndpointOptionsFromEnv 

func EndpointOptionsFromEnv() (gcorecloud.EndpointOpts, error)

func NewGCloudAPITokenAPISettingsFromEnv added in v0.4.32 

func NewGCloudAPITokenAPISettingsFromEnv() (*gcorecloud.APITokenAPISettings, error)

func NewGCloudPlatformAPISettingsFromEnv 

func NewGCloudPlatformAPISettingsFromEnv() (*gcorecloud.PasswordAPISettings, error)

func NewGCloudTokenAPISettingsFromEnv 

func NewGCloudTokenAPISettingsFromEnv() (*gcorecloud.TokenAPISettings, error)

func NewGCoreClient 

func NewGCoreClient(endpoint string) (*gcorecloud.ProviderClient, error)

NewGCoreClient prepares an unauthenticated ProviderClient instance. Most users will probably prefer using the AuthenticatedClient function instead.

This is useful if you wish to explicitly control the version of the identity service that's used for authentication explicitly, for example.

func NewIdentity 

func NewIdentity(client *gcorecloud.ProviderClient, eo gcorecloud.EndpointOpts) (*gcorecloud.ServiceClient, error)

NewIdentity creates a ServiceClient that may be used to interact with the gcore identity auth service.

func NewK8sV1 

func NewK8sV1(provider *gcorecloud.ProviderClient, region int, project int) (*gcorecloud.ServiceClient, error)

func TokenClient 

func TokenClient(options gcorecloud.TokenOptions) (*gcorecloud.ProviderClient, error)

func TokenClientService 

func TokenClientService(options gcorecloud.TokenOptions, eo gcorecloud.EndpointOpts) (*gcorecloud.ServiceClient, error)

func TokenClientServiceWithDebug 

func TokenClientServiceWithDebug(options gcorecloud.TokenOptions, eo gcorecloud.EndpointOpts, debug bool) (*gcorecloud.ServiceClient, error)

func TokenClientWithDebug 

func TokenClientWithDebug(options gcorecloud.TokenOptions, debug bool) (*gcorecloud.ProviderClient, error)

func TokenOptionsFromEnv 

func TokenOptionsFromEnv() (gcorecloud.TokenOptions, error)

Types

type ErrEndpointNotFound 

type ErrEndpointNotFound struct{ gcorecloud.BaseError }

ErrEndpointNotFound is the error when no suitable endpoint can be found in the user's catalog

func (ErrEndpointNotFound) Error 

func (e ErrEndpointNotFound) Error() string

type ErrInvalidAvailabilityProvided 

type ErrInvalidAvailabilityProvided struct{ gcorecloud.ErrInvalidInput }

ErrInvalidAvailabilityProvided is the error when an invalid endpoint availability is provided

func (ErrInvalidAvailabilityProvided) Error 

func (e ErrInvalidAvailabilityProvided) Error() string

type ErrNoAuthURL 

type ErrNoAuthURL struct{ gcorecloud.ErrInvalidInput }

ErrNoAuthURL is the error when the OS_AUTH_URL environment variable is not found

func (ErrNoAuthURL) Error 

func (e ErrNoAuthURL) Error() string

type ErrNoPassword 

type ErrNoPassword struct{ gcorecloud.ErrInvalidInput }

ErrNoPassword is the error when the OS_PASSWORD environment variable is not found

func (ErrNoPassword) Error 

func (e ErrNoPassword) Error() string

type ErrNoUsername 

type ErrNoUsername struct{ gcorecloud.ErrInvalidInput }

ErrNoUsername is the error when the OS_USERNAME environment variable is not found

func (ErrNoUsername) Error 

func (e ErrNoUsername) Error() string

Source Files

View all Source files

Directories

Path Synopsis
ai
v1/aiflavors
v1/aiflavors/testing
v1/aiimages
v1/aiimages/testing
v1/ais
v1/ais/testing
apitoken
v1/apitokens
v1/apitokens/testing
v1/types
apptemplate
v1/apptemplates
v1/apptemplates/testing
baremetal
v1/bmcapacity
v1/bmcapacity/testing
v1/bminstances
v1/bminstances/testing
ddos
v1/ddos
v1/ddos/testing
ddos unit tests
 ddos unit tests
faas
v1/faas
v1/faas/testing
file_share
v1/file_shares
v1/file_shares/testing
file shares unit tests
 file shares unit tests
flavor
v1/flavors
Package flavors contains functionality for working GCLoud flavors API resources
 Package flavors contains functionality for working GCLoud flavors API resources
v1/flavors/testing
flavors unit tests
 flavors unit tests
floatingip
v1/availablefloatingips
v1/availablefloatingips/testing
v1/floatingips
v1/floatingips/testing
heat
v1/stack/resources
v1/stack/resources/testing
resources unit tests
 resources unit tests
v1/stack/resources/types
v1/stack/stacks
v1/stack/stacks/testing
v1/stack/stacks/types
identity
tokens
tokens/testing
tokens unit tests
 tokens unit tests
image
v1/images
v1/images/testing
v1/images/types
instance
v1/instances
v1/instances/testing
instances unit tests
 instances unit tests
v1/types
v2/instances
v2/types
k8s
v2/clusters
v2/clusters/testing
v2/pools
v2/pools/testing
keypair
v1/keypairs
Package keypair contains functionality for working GCLoud keypairs API resources
 Package keypair contains functionality for working GCLoud keypairs API resources
v1/keypairs/testing
keypairs unit tests
 keypairs unit tests
v2/keypairs
v2/keypairs/testing
keystone
v1/keystones
v1/keystones/testing
v1/types
laas
v1/laas
v1/laas/testing
lifecyclepolicy
v1/lifecyclepolicy
v1/lifecyclepolicy/testing
limit
v2/limits
v2/limits/testing
v2/types
loadbalancer
v1/l7policies
v1/l7policies/testing
v1/lbflavors
v1/lbflavors/testing
v1/lbpools
v1/lbpools/testing
loadbalancers unit tests
 loadbalancers unit tests
v1/listeners
v1/listeners/testing
listeners unit tests
 listeners unit tests
v1/loadbalancers
Package loadbalancer contains functionality for working GCLoud loadbalancers API resources
 Package loadbalancer contains functionality for working GCLoud loadbalancers API resources
v1/loadbalancers/testing
loadbalancers unit tests
 loadbalancers unit tests
v1/types
v2/testing
network
v1/availablenetworks
Package network contains functionality for working GCLoud networks API resources
 Package network contains functionality for working GCLoud networks API resources
v1/availablenetworks/testing
networks unit tests
 networks unit tests
v1/extensions
v1/extensions/testing
extensions unit tests
 extensions unit tests
v1/networks
Package network contains functionality for working GCLoud networks API resources
 Package network contains functionality for working GCLoud networks API resources
v1/networks/testing
networks unit tests
 networks unit tests
port
v1/ports
v1/ports/testing
project
v1/projects
v1/projects/testing
v1/types
quota
v2/quotas
v2/quotas/testing
region
v1/regions
v1/regions/testing
v1/types
regionaccess
v1/regionsaccess
v1/regionsaccess/testing
reservedfixedip
v1/reservedfixedips
v1/reservedfixedips/testing
router
v1/routers
v1/routers/testing
routers unit tests
 routers unit tests
v1/types
schedule
v1/schedules
v1/schedules/testing
secret
v1/secrets
v1/secrets/testing
v2/secrets
v2/secrets/testing
securitygroup
v1/securitygrouprules
v1/securitygrouprules/testing
v1/securitygroups
v1/securitygroups/testing
v1/types
servergroup
v1/servergroups
v1/servergroups/testing
snapshot
v1/snapshots
v1/snapshots/testing
subnet
v1/subnets
v1/subnets/testing
subnets unit tests
 subnets unit tests
task
v1/tasks
v1/tasks/testing
tasks unit tests
 tasks unit tests
users
v1/users
v1/users/testing
metadata
metadata/v1/metadata
metadata/v1/metadata/testing
metadata/v2/metadata
metadata/v2/metadata/testing
testing
volume
v1/volumes
Package volume contains functionality for working GCLoud volumes API resources
 Package volume contains functionality for working GCLoud volumes API resources
v1/volumes/testing
volumes unit tests
 volumes unit tests
v2/volumes
v2/volumes/testing

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.