crossplane
/
docs
mirror of https://github.com/crossplane/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs snapshot for crossplane version `master`

This commit is contained in:
Crossplane 2020-02-03 21:55:55 +00:00
parent 2690ea8366
commit 0f109d6c25
1 changed files with 19 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
docs/master/services/gcp-services-guide.md
View File

@ -31,7 +31,7 @@ your existing Kubernetes cluster and Crossplane managed resources. We will:
## Pre-requisites ## Pre-requisites
* [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) * [kubectl]
* A GKE cluster. * A GKE cluster.
## Preparation ## Preparation
@ -52,14 +52,10 @@ export NETWORK_NAME=default # the network that your GKE cluster lives in.
### Installation ### Installation
Assuming you are Assuming you are [connected] to your GKE cluster via `kubectl`:
[connected](https://cloud.google.com/kubernetes-engine/docs/how-to/cluster-access-for-kubectl)
to your GKE cluster via `kubectl`:
* Install Crossplane from alpha channel using the [Crossplane Installation * Install Crossplane from alpha channel using the [Crossplane Installation Guide]
Guide](../install-crossplane.md#alpha) * Install the GCP stack into Crossplane using the [GCP stack section] of the install guide.
* Install the GCP stack into Crossplane using the [GCP stack
section](../install-crossplane.md#gcp-stack) of the install guide.
To keep your resource configuration organized, start by creating a new To keep your resource configuration organized, start by creating a new
directory: directory:
@ -71,14 +67,13 @@ mkdir wordpress && cd $_
### Cloud Provider ### Cloud Provider
It is essential to make sure that the GCP user credentials are configured in It is essential to make sure that the GCP user credentials are configured in
Crossplane as a provider. Please follow the steps in the GCP [provider Crossplane as a provider. Please follow the steps in the GCP [provider guide] for more information.
guide](../cloud-providers/gcp/gcp-provider.md) for more information.
### Resource Classes ### Resource Classes
Resource classes are used to define a reusable configuration for a specific Resource classes are used to define a reusable configuration for a specific
managed service. Wordpress requires a MySQL database, which can be satisfied by managed service. Wordpress requires a MySQL database, which can be satisfied by
a [Google Cloud SQL Instance](https://cloud.google.com/sql/docs/mysql/). a [Google Cloud SQL Instance].
* Define a GCP CloudSQL class `CloudSQLInstanceClass`: * Define a GCP CloudSQL class `CloudSQLInstanceClass`:
@ -131,9 +126,7 @@ field `storageGB: 100`.
### Configure Managed Service Access ### Configure Managed Service Access
Before we install Wordpress, we need to establish connectivity between the the Before we install Wordpress, we need to establish connectivity between the the
MySQL database and the GKE cluster. We can do this by creating a [Private MySQL database and the GKE cluster. We can do this by creating a [Private Service Connection].
Service
Connection](https://cloud.google.com/vpc/docs/configure-private-services-access).
You can create it by following the instructions at the link above, or you could You can create it by following the instructions at the link above, or you could
use Crossplane to do it: use Crossplane to do it:
@ -188,7 +181,7 @@ use Crossplane to do it:
*Output* *Output*
```yaml ```
Name: example-connection Name: example-connection
Namespace: Namespace:
Labels: <none> Labels: <none>
@ -244,8 +237,7 @@ several ways: (a) rely on the default class marked
`claim.spec.classRef` to a specific class, or (c) match on class labels using a `claim.spec.classRef` to a specific class, or (c) match on class labels using a
`claim.spec.classSelector`. `claim.spec.classSelector`.
*Note: claims may also be used in [static *Note: claims may also be used in [static provisioning] with a reference
provisioning](../concepts.md#dynamic-and-static-provisioning) with a reference
to an existing managed resource.* to an existing managed resource.*
In the `CloudSQLInstanceClass` above, we added the label `size: standard`, so In the `CloudSQLInstanceClass` above, we added the label `size: standard`, so
@ -515,14 +507,15 @@ database.
We deployed Wordpress using bare `Deployment` and `Service` resources but there We deployed Wordpress using bare `Deployment` and `Service` resources but there
is actually a Wordpress App stack that creates these resources for us! is actually a Wordpress App stack that creates these resources for us!
Check out the [stacks guides](../stacks-guide.md)! Check out the [stacks guides]!
## References [kubectl]: https://kubernetes.io/docs/tasks/tools/install-kubectl
[connected]: https://cloud.google.com/kubernetes-engine/docs/how-to/cluster-access-for-kubectl
[Crossplane Installation Guide]: ../install-crossplane.md#alpha
[GCP stack section]: ../install-crossplane.md#gcp-stack
[provider guide]: ../cloud-providers/gcp/gcp-provider.md
[Google Cloud SQL Instance]: https://cloud.google.com/sql/docs/mysql/
[Private Service Connection]: https://cloud.google.com/vpc/docs/configure-private-services-access
[static provisioning]: ../concepts.md#dynamic-and-static-provisioning
[stacks guides]: ../stacks-guide.md
* [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
* [Crossplane Installation Guide](../install-crossplane.md#alpha)
* [GCP Stack Installation](../install-crossplane.md#gcp-stack)
* [GCP Provider Guide](../cloud-providers/gcp/gcp-provider.md)
* [Google Cloud SQL Instance](https://cloud.google.com/sql/docs/mysql/)
* [Default Resource Classes One-Pager](https://github.com/crossplaneio/crossplane/blob/master/design/one-pager-default-resource-class.md)
* [Google Private Service Connection](https://cloud.google.com/vpc/docs/configure-private-services-access)