Merge pull request #636 from oracle-devrel/storage.01.50.27.11.2023

Update based on Review of our Confluence and GitHub assets

Author: AlexanderHodicke

cloud-infrastructure/storage/block-storage/README.md

@@ -8,17 +8,22 @@ We've designed our storage platform as an ideal complement to Oracle compute and
 # Table of Contents
 
 1. [Team Publications](#team-publications)
-2. [Useful Links](#useful-uinks)
-3. [Reusable Assets Overview](#reusable-assets-overview)
+2. [Useful Links](#useful-links)
 
 ## Team Publications
 
-- [OCI provides native high availability and data resilience](https://blogs.oracle.com/cloud-infrastructure/post/oci-provide-cloud-resilience-by-default)
-    - Blog: Oracle Cloud Infrastructure (OCI) provides high data durability and availability as a core feature, enabling businesses to concentrate on their customer experience and economic success.
-- [Make your cloud resilient against regional outages](https://www.youtube.com/watch?v=IVqLe_XH_AE)
-    - 6-minute Video about "Make your cloud resilient against regional outages".
-- [Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure](https://www.youtube.com/watch?v=P3qWyjE9HMQ)
-    - 1h Video about "Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure".
+- [OCI provides native high availability and data resilience](asset/OCI.provides.native.high.availability.and.data.resilience)
+- [Make your cloud resilient against regional outages](asset/Make.your.cloud.resilient.against.regional.outages)
+- [Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure](asset/Effortless.Cloud.Resilience)
+- [Cloud Resilience](asset/Cloud.Resilience)
+- [Cloud Resilience by default](asset/Cloud.Resilience.by.default)
+- [OCI Storage Health-Check](asset/OCI.Storage.Health-Check)
+- Showcase section
+  - [Showcase 1: Demonstrate block volume backup copy to a different region in a customer managed key environment.](asset/Showcase.1)
+  - [Showcase 2: TRIM showcase](asset/Showcase.2)
+  - [Showcase 3: boot/block volume security best practice](asset/Showcase.3)
+  - [Showcase 4: boot/block volume individual (to a customer-managed bucket) backup and restore](asset/Showcase.4)
+
 
 ## Useful Links
 
@@ -37,30 +42,6 @@ We've designed our storage platform as an ideal complement to Oracle compute and
 - [Oracle Cloud Infrastructure Vault: Block Volume Encryption](https://www.youtube.com/watch?v=3GBPIx4hlRU)
   - This video helps you to encrypt a block volume with the KMS Vault customer-managed encryption key.
 
-## Reusable Assets Overview
-
-- [Cloud Resilience](https://gitlab.com/hmielimo/cloud-resilience/-/blob/main/doc/cloud.resilience/README.md)
-  - All details regarding storage-based resiliency incl. example backup and recovery automation script.
-- [Cloud Resilience by default](https://gitlab.com/hmielimo/cloud-resilience-by-default/)
-  - All details regarding storage-based Server resiliency including
-    - Set up your Server with Resilience by default Using the Console
-    - Set up your Server with Resilience by default using CLI
-    - Performance-Based Auto-tune Use Case script
-- [OCI Storage Health-Check](https://gitlab.com/hmielimo/oci-storage-health-check/)
-  - Storage Health-Check example scripts
-    - validate all boot and block volumes regarding backup policies
-    - showcase boot and block volume security e.g. using Customer managed key, Key-Rotation, Backup
-- Showcase section
-  - [Showcase 1: Demonstrate block volume backup copy to a different region in a customer managed key environment.](https://gitlab.com/hmielimo/cloud-resilience-by-default/-/tree/main/copy.customer.managed.key.backup)
-    - we showcase a: cli management of several customer managed key protected OCI resources (e.g. instance, block volume, block volume backup)
-    - we showcase b: cli based customer managed key protected block volume creation, attachment to instance, create filesystem
-    - we showcase c: cli based customer managed key protected block volume backup
-    - we showcase d: cli based customer managed key protected block volume backup copy to a different region
-    - we showcase e: cli based customer managed key protected instance using Cloud-Init to run custom scripts or provide custom Cloud-Init configuration
-    - we showcase f: cli based customer managed key protected instance using Consistent device paths fot attached block volumes
-  - [TRIM showcase - example script](asset/trim-showcase.md)
-  - [boot/block volume security best practice - example script](asset/secure.storage.sh)
-  - [boot/block volume individual (to a customer-managed bucket) backup and restore  - example script](asset/block-volume-backup-and-restore.md)
 
 
 
@@ -70,4 +51,4 @@ Copyright (c) 2023 Oracle and/or its affiliates.
 
 Licensed under the Universal Permissive License (UPL), Version 1.0.
 
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folder-structure/LICENSE) for more details.
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/Cloud.Resilience.by.default/README.md

@@ -0,0 +1,27 @@
+# Cloud Resilience by default
+
+[Cloud Resilience by default](https://gitlab.com/hmielimo/cloud-resilience-by-default/)
+
+Assets that contain all details regarding storage-based Server resiliency. This assets provide
+- Set up your Server with Resilience by default Using the Console
+- Set up your Server with Resilience by default using CLI
+- Performance-Based Auto-tune Use Case script
+
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever needed to implement resilient solutions with Oracle Cloud Infrastructure (OCI).
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/Cloud.Resilience/README.md

@@ -0,0 +1,28 @@
+# Cloud Resilience
+
+[Cloud Resilience](https://gitlab.com/hmielimo/cloud-resilience/-/blob/main/doc/cloud.resilience/README.md)
+
+Assets that contain a great opportunity to learn about Cloud Resilience or "Keep your systems running". This assets provide
+- A theoretical overview
+- An alignment of terms across several cloud provides like e.g. Oracle, Amazon, Google and Microsoft
+- A hands on guidance on a real world example based on which you are able to gain insides for your individual cloud resilience implementation
+- A list of Oracle Architectural Best Practices
+
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever needed to implement resilient solutions with Oracle Cloud Infrastructure (OCI).
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/Effortless.Cloud.Resilience/README.md

@@ -0,0 +1,23 @@
+# Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure
+
+[Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure](https://www.youtube.com/watch?v=P3qWyjE9HMQ)
+
+Assets that contain a great opportunity to learn how to use the powerful tools of OCI to improve the resilience and availability of your systems.
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever needed to implement resilient solutions with Oracle Cloud Infrastructure (OCI).
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/Make.your.cloud.resilient.against.regional.outages/README.md

@@ -0,0 +1,24 @@
+# Make your cloud resilient against regional outages
+
+[Make your cloud resilient against regional outages](https://www.youtube.com/watch?v=IVqLe_XH_AE)
+
+Assets that contain a 6-minute Video about "Make your cloud resilient against regional outages".
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever needed to implement cloud resiliency against regional outages.
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.
+

cloud-infrastructure/storage/block-storage/asset/OCI.Storage.Health-Check/README.md

@@ -0,0 +1,29 @@
+# OCI Storage Health-Check
+
+[OCI Storage Health-Check](https://gitlab.com/hmielimo/oci-storage-health-check/)
+
+Assets that contain OCI Storage Health-Check. This address perfectly [Best practices framework for Oracle Cloud Infrastructure](https://docs.oracle.com/en/solutions/oci-best-practices/index.html) in general and [Backup Data in Storage Services - Oracle Cloud Infrastructure Block Volumes](https://docs.oracle.com/en/solutions/oci-best-practices/back-your-data1.html) in particular.
+In addition you might make use of [Storage Healthcheck list](https://gitlab.com/hmielimo/oci-storage-health-check/-/blob/main/doc/healthcheck.storage.xlsx) where we list all storage related OCI best practices of the following areas:
+
+- Security and compliance
+- Reliability and resilience
+- Performance and cost optimization
+- Operational efficiency
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever you plan or already have implemented OCI Storage Services and aim to compare your implementation aginst the [Best practices framework for Oracle Cloud Infrastructure](https://docs.oracle.com/en/solutions/oci-best-practices/index.html).
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/OCI.provides.native.high.availability.and.data.resilience/README.md

@@ -0,0 +1,23 @@
+# OCI provides native high availability and data resilience
+
+[OCI provides native high availability and data resilience](https://blogs.oracle.com/cloud-infrastructure/post/oci-provide-cloud-resilience-by-default)
+
+Assets that contain solution design practice regarding Oracle Cloud Infrastructure (OCI) native high availability and data resilience capabilities.
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever needed to design resilient solutions with Oracle Cloud Infrastructure (OCI).
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/README.md

@@ -1,12 +1,23 @@
 # Asset
 
-OCI Block Storage assets.
 
+Assets contain all OCI Block Storage assets.
+
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever work with Oracle Cloud Infrastructure (OCI) Block Storage.
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
 
 # License
 
 Copyright (c) 2023 Oracle and/or its affiliates.
 
 Licensed under the Universal Permissive License (UPL), Version 1.0.
 
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folder-structure/LICENSE) for more details.
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/Showcase.1/README.md

@@ -0,0 +1,24 @@
+# Showcase 1: Demonstrate block volume backup copy to a different region in a customer managed key environment
+
+[Showcase 1: Demonstrate block volume backup copy to a different region in a customer managed key environment.](https://gitlab.com/hmielimo/cloud-resilience-by-default/-/tree/main/copy.customer.managed.key.backup)
+
+Assets that contain a great opportunity to learn about Customer managed (boot and block) volume backups and how to copy them to a different region.
+
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever need to implement a customer managed (boot and block) volume backup and copy them to a different region.
+
+# How to use this asset?
+
+The information is generic in nature and not specified for a particular customer.
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.

cloud-infrastructure/storage/block-storage/asset/trim-showcase.md renamed to cloud-infrastructure/storage/block-storage/asset/Showcase.2/README.md

@@ -1,18 +1,31 @@
-# License
+# Showcase 2: TRIM showcase
 
-Copyright (c) 2023 Oracle and/or its affiliates.
+[Showcase 2: TRIM showcase](#showcase-trim)
 
-Licensed under the Universal Permissive License (UPL), Version 1.0.
+Assets that contain a great opportunity to learn about Cloud Resilience or "Keep your systems running". This assets provide
+- A theoretical overview
+- An alignment of terms across several cloud provides like e.g. Oracle, Amazon, Google and Microsoft
+- A hands on guidance on a real world example based on which you are able to gain insides for your individual cloud resilience implementation
+- A list of Oracle Architectural Best Practices
+
+
+Reviewed: 27.11.2023
+
+# When to use this asset?
+
+These assets should be used whenever you like to understand TRIM in Oracle Cloud Infrastructure (OCI) Storage Services.
+
+# How to use this asset?
 
-See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folder-structure/LICENSE) for more details.
+The information is generic in nature and not specified for a particular customer.
 
 
 # Showcase TRIM
 
 ## Prepare your environment
 - [Oracle Cloud Infrastructure CLI Command Reference](https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/index.html)
 - Set up your individual "operate" instance
-	- An Oracle enterprise Linux server with Command Line Interface (*see [Set up your Server with Resilience by default using CLI](https://gitlab.com/hmielimo/cloud-resilience-by-default/#set-up-your-server-with-resilience-by-default-using-cli)  for details*).
+	- An Oracle enterprise Linux server with Command Line Interface (*see [How to create a new operate server](https://gitlab.com/hmielimo/next-generation-cloud/-/tree/main/doc/how.to.create.a.new.operate.server)  for details*).
 	- Create and attach block volume: e.g. trim-test (*200GB*).
 
 ## Format and mount block volume
@@ -197,3 +210,11 @@ done
 
 cat "${myLOGFILE}"
 ~~~
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/main/LICENSE) for more details.