diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/sections/blueprints/PGaaS.rst | 29 |
1 files changed, 25 insertions, 4 deletions
diff --git a/docs/sections/blueprints/PGaaS.rst b/docs/sections/blueprints/PGaaS.rst index 1b32d420..39d309f1 100644 --- a/docs/sections/blueprints/PGaaS.rst +++ b/docs/sections/blueprints/PGaaS.rst @@ -18,9 +18,30 @@ volumes matches the lifetime of the blueprint deployment. So when the blueprint goes away, any Cinder storage volume allocated in the blueprint also goes away. -Similarly, a database's lifetime should have its +Similarly, a database's lifetime may be the same time as an application's +lifetime. When the application is undeployed, the associated database should +be deployed too. OR, the database should have a lifetime beyond the scope +of the applications that are writing to it or reading from it. -The all-in-one blueprint assumes that everything can be allocated and -deallocated together. +The Blueprints for PG Services and Cinder +------------ + +The all-in-one blueprint PGaaS.yaml assumes that the PG servers and Cinder volumes can be allocated and +deallocated together. This PGaaS.yaml blueprint creates a cluster named "pstg" by default. + +Alternatively, you can split them apart into separate steps, using PGaaS-disk.yaml to allocate the +Cinder volume, and PGaaS-cluster.yaml to allocate a PG cluster. Create the Cinder volume first using +PGaaS-disk.yaml, and then use PGaaS-cluster.yaml to create the cluster. The PG cluster can be +redeployed without affecting the data on the Cinder volumes. + +The Blueprints for Databases +------------ + +The PGaaS-database.yaml blueprint shows how a database can be created separately from any application +that uses it. That database will remain present until the PGaaS-database.yaml blueprint is +undeployed. The PGaaS-getdbinfo.yaml file demonstrates how an application would access the credentials +needed to access a given database on a given PostgreSQL cluster. -MORE TO BE ADDED +If the lifetime of your database is tied to the lifetime of your application, use a block similar to what +is in PGaaS-database.yaml to allocate the database, and use the attributes as shown in PGaaS-getdbinfo.yaml +to access the credentials. |