Skip to content

Commit 4983b29

Browse files
HeinzOracleHeinzOracle
committed
Merge branch 'block.storage.01.00.28.06.2023' of https://github.com/oracle-devrel/technology-engineering into block.storage.01.00.28.06.2023
2 parents 7dbbfa2 + 4335680 commit 4983b29

File tree

4 files changed

+47
-47
lines changed

4 files changed

+47
-47
lines changed

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

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -16,39 +16,39 @@ We've designed our storage platform as an ideal complement to Oracle compute and
1616
- [OCI provides native high availability and data resilience](https://blogs.oracle.com/cloud-infrastructure/post/oci-provide-cloud-resilience-by-default)
1717
- 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.
1818
- [Make your cloud resilient against regional outages](https://www.youtube.com/watch?v=IVqLe_XH_AE)
19-
- 6-minute Video about "Make your cloud resilient against regional outages"
19+
- 6-minute Video about "Make your cloud resilient against regional outages".
2020
- [Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure](https://www.youtube.com/watch?v=P3qWyjE9HMQ)
21-
- 1h Video about "Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure"
21+
- 1h Video about "Effortless Cloud Resilience – Automate your Disaster Recovery with Oracle Cloud Infrastructure".
2222

2323
## Useful Links
2424

2525
- [OCI Block Storage documentation](https://docs.oracle.com/en-us/iaas/Content/Block/home.htm)
26-
- Oracle Block Storage documentation
26+
- Oracle Block Storage documentation.
2727
- Introduction to Oracle Cloud Infrastructure Block Volume [Part 01](https://www.youtube.com/watch?v=rNrBxdDC8vc) and [Part 02](https://www.youtube.com/watch?v=ldZDySWv8sw)
28-
- Short Videos to introduce Oracle Cloud Infrastructure Block Volume
28+
- Short Videos to introduce Oracle Cloud Infrastructure Block Volume.
2929
- [OCI Block Storage on oracle.com](https://www.oracle.com/cloud/storage/block-volumes/)
3030
- Oracle Cloud Infrastructure (OCI) Block Volumes provide reliable, high-performance, low-cost block storage. OCI Block Volumes persist beyond the lifespan of a virtual machine, have built-in redundancy, and can scale to 1 PB per compute instance.
3131
- [Blogs on Block Storage](https://blogs.oracle.com/authors/max-verun)
32-
- See all Block Storage Blogs from Oracle's Product Management
32+
- See all Block Storage Blogs from Oracle's Product Management.
3333
- [Block Storage Release Notes](https://docs.oracle.com/en-us/iaas/releasenotes/services/blockvolume/)
3434
- [Block Volumes FAQ](https://www.oracle.com/cloud/storage/block-volumes/faq)
3535
- [Oracle Cloud Infrastructure Service Level Agreement (SLA)](https://www.oracle.com/cloud/sla/)
3636
- Enterprises demand more than just availability from their cloud infrastructure. Mission-critical workloads also require consistent performance, and the ability to manage, monitor, and modify resources running in the cloud at any time. Only Oracle offers end-to-end SLAs covering the performance, availability, and manageability of services.
3737
- [Oracle PaaS and IaaS Public Cloud Services Pillar Document Block Storage](https://www.oracle.com/assets/paas-iaas-pub-cld-srvs-pillar-4021422.pdf#page=28)
3838
- Oracle offers end-to-end SLAs covering performance, availability, and manageability. Here you find details regarding Block Storage.
3939
- [Oracle PaaS and IaaS Universal Credits Service Descriptions - Storage section](https://www.oracle.com/us/corporate/contracts/paas-iaas-universal-credits-3940775.pdf#page=178)
40-
- OCI Block Storage Service Description
40+
- OCI Block Storage Service Description.
4141
- [Resilience and Continuous Availability of Oracle Cloud Infrastructure Services and Platform FAQ](https://www.oracle.com/cloud/iaas/faq.html)
42-
- Resilience and Continuous Availability FAQs
42+
- Resilience and Continuous Availability FAQs.
4343
- [Oracle Cloud Infrastructure Vault: Block Volume Encryption](https://www.youtube.com/watch?v=3GBPIx4hlRU)
4444
- This video helps you to encrypt a block volume with the KMS Vault customer-managed encryption key.
4545

4646
## Reusable Assets Overview
4747

4848
- [Cloud Resilience](https://gitlab.com/hmielimo/cloud-resilience/-/blob/main/doc/cloud.resilience/README.md)
49-
- All details regarding storage-based resiliency incl. example backup and recovery automation script
49+
- All details regarding storage-based resiliency incl. example backup and recovery automation script.
5050
- [Cloud Resilience by default](https://gitlab.com/hmielimo/cloud-resilience-by-default/)
51-
- All details regarding storage-based Server resiliency incl.
51+
- All details regarding storage-based Server resiliency including
5252
- Set up your Server with Resilience by default Using the Console
5353
- Set up your Server with Resilience by default using CLI
5454
- Performance-Based Auto-tune Use Case script

‎cloud-infrastructure/storage/block-storage/asset/parameter1.sh

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -18,30 +18,30 @@
1818
# ---------------------------------------------------------------------------------------------------------------------------------------------
1919
# CUSTOMER SPECIFIC VALUES - please update appropriate
2020
# ---------------------------------------------------------------------------------------------------------------------------------------------
21-
export COMPARTMENT_OCID=<your_compartment> # Compartment Name:
22-
export REGION_PROFILE=FRANKFURT # oci region profile e.g. frankfurt
21+
export COMPARTMENT_OCID=<your_compartment> # Compartment Name:
22+
export REGION_PROFILE=<your_region> # oci region profile e.g. frankfurt
2323
export CREATE_BLOCK_VOLUME=0 # create Block volume 0=no // 1=yes
24-
export CREATE_BLOCK_VOLUME_BACKUP=0 # create Block volume backup 0=no // 1=yes
24+
export CREATE_BLOCK_VOLUME_BACKUP=0 # create Block volume backup 0=no // 1=yes
2525

2626
# ---------------------------------------------------------------------------------------------------------------------------------------------
2727
# SECURITY SPECIFIC VALUES - please update appropriate
2828
# ---------------------------------------------------------------------------------------------------------------------------------------------
2929
export AD=<your_ad_number> #
30-
export AD_PREFIX=<your_prefix> # Prifix of Availability Domain
31-
export FRANKFURT_REGION_IDENTIFIER=<your_region_identifier> #
32-
export FRANKFURT_BLOCK_VOLUME_NAME=BlockVolumeFrankfurt #
33-
export FRANKFURT_AVAILABILITY_DOMAIN="${AD_PREFIX}:${FRANKFURT_REGION_IDENTIFIER}-AD-${AD}" # [AD Prefix]:[Region Identifier]-AD-[Number of Availability Domain] see https://docs.oracle.com/en-us/iaas/Content/General/Concepts/regions.htm
30+
export AD_PREFIX=<your_prefix> # Prifix of Availability Domain
31+
export FRANKFURT_REGION_IDENTIFIER=<your_region_identifier> #
32+
export FRANKFURT_BLOCK_VOLUME_NAME=BlockVolumeFrankfurt #
33+
export FRANKFURT_AVAILABILITY_DOMAIN="${AD_PREFIX}:${FRANKFURT_REGION_IDENTIFIER}-AD-${AD}" # [AD Prefix]:[Region Identifier]-AD-[Number of Availability Domain] see https://docs.oracle.com/en-us/iaas/Content/General/Concepts/regions.htm
3434
export VAULT_OCID=<your_vault_ocid> # Vault OCID
35-
export MasterEncryptionKey_OCID=<your_masterencryptionkey_ocid> # MasterEncryptionKey OCID
35+
export MasterEncryptionKey_OCID=<your_masterencryptionkey_ocid> # MasterEncryptionKey OCID
3636

3737
# ---------------------------------------------------------------------------------------------------------------------------------------------
3838
# VALUES (normally do not touch)
3939
# ---------------------------------------------------------------------------------------------------------------------------------------------
40-
export LOG_FILE=<your_log_file_name_including_the_path> #
41-
export DEBUG_LEVEL=0 # 0 (off); 1 (low); 2 (high)
42-
export PF1=### # Prefix 1 - used to introduce function
40+
export LOG_FILE=<your_log_file_name_including_the_path> #
41+
export DEBUG_LEVEL=0 # 0 (off); 1 (low); 2 (high)
42+
export PF1=### # Prefix 1 - used to introduce function
4343
export PF2="${PF1}.###:" # Prefix 2 - used to log informations inside functions
44-
export MYcolor="${IYellow}" # define output color
44+
export MYcolor="${IYellow}" # define output color
4545
if [ ${DEBUG_LEVEL} -eq 0 ] ; then export MYcolor=$ICyan ; fi
4646
if [ ${DEBUG_LEVEL} -eq 1 ] ; then export MYcolor=$IPurple ; fi
4747
if [ ${DEBUG_LEVEL} -eq 2 ] ; then export MYcolor=$IRed ; fi

‎cloud-infrastructure/storage/block-storage/asset/secure.storage.sh

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ source functions0.sh
2727
# Oracle Cloud Infrastructure CLI Command Reference - https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/
2828
# ---------------------------------------------------------------------------------------------------------------------------------------------
2929

30-
MYOUTPUT="Secure Storage by example - Preperation" && MYCOUNT=$((1))
30+
MYOUTPUT="Secure Storage by Example - Preperation" && MYCOUNT=$((1))
3131
if [ 1 -eq 1 ] ; then
3232
color_print "${IGreen}" "($MYCOUNT) $(date "+%d.%m.%Y %H:%M:%S") : $MYOUTPUT"
3333

@@ -42,8 +42,8 @@ if [ 1 -eq 1 ] ; then # create BLOCK volume
4242
if [ ${CREATE_BLOCK_VOLUME} -eq 1 ] ; then # create block volume
4343
oci --profile "${REGION_PROFILE}" bv volume create --availability-domain "${FRANKFURT_AVAILABILITY_DOMAIN}" \
4444
--compartment-id "${COMPARTMENT_OCID}" \
45-
--display-name "${FRANKFURT_BLOCK_VOLUME_NAME}" \
46-
--size-in-gbs 50 \
45+
--display-name "${FRANKFURT_BLOCK_VOLUME_NAME}" \
46+
--size-in-gbs 50 \
4747
--wait-for-state "AVAILABLE"
4848
fi
4949

@@ -102,7 +102,7 @@ echo " " >> "${LOG_FILE}"
102102
fi
103103

104104

105-
MYOUTPUT="Secure Storage with Customer managed Key" && MYCOUNT=$(($MYCOUNT + 1))
105+
MYOUTPUT="Secure Storage with Customer-managed Key" && MYCOUNT=$(($MYCOUNT + 1))
106106
if [ 1 -eq 1 ] ; then
107107
color_print "${IGreen}" "($MYCOUNT) $(date "+%d.%m.%Y %H:%M:%S") : $MYOUTPUT"
108108

@@ -116,25 +116,25 @@ echo "=====================================================================" >>
116116
echo "${PF1} $(date "+%d.%m.%Y %H:%M:%S")" >> "${LOG_FILE}"
117117
echo "${PF1} --------------------------------------------------------------" >> "${LOG_FILE}"
118118

119-
color_print "${MYcolor}" "${PF1} BLOCK volume change from Oracle managed Key to Customer managed Key"
120-
if [ 1 -eq 1 ] ; then # BLOCK volume change from Oracle managed Key to Customer managed Key
119+
color_print "${MYcolor}" "${PF1} BLOCK volume change from Oracle-managed Key to Customer-managed Key"
120+
if [ 1 -eq 1 ] ; then # BLOCK volume change from Oracle-managed Key to Customer-managed Key
121121
oci --profile "${REGION_PROFILE}" bv volume-kms-key update --volume-id "${BLOCK_VOLUME_OCID}" --kms-key-id "${MasterEncryptionKey_OCID}"
122-
echo "${PF1} BLOCK volume change from Oracle managed Key to Customer managed Key" >> "${LOG_FILE}"
122+
echo "${PF1} BLOCK volume change from Oracle-managed Key to Customer-managed Key" >> "${LOG_FILE}"
123123
fi
124124

125-
color_print "${MYcolor}" "${PF1} BLOCK volume backup change from Oracle managed Key to Customer managed Key (coming soon)"
126-
if [ 1 -eq 0 ] ; then # BLOCK volume backup change from Oracle managed Key to Customer managed Key (coming soon)
125+
color_print "${MYcolor}" "${PF1} BLOCK volume backup change from Oracle-managed Key to Customer-managed Key (coming soon)"
126+
if [ 1 -eq 0 ] ; then # BLOCK volume backup change from Oracle-managed Key to Customer-managed Key (coming soon)
127127
: ' ---------------------------------------------------------------------------------------------------------------------------------------
128128
Backup Data in Storage Services https://docs.oracle.com/en/solutions/oci-best-practices/back-your-data1.html
129129
-------------------------------------------------------------------------------------------------------------------------------------------'
130130
oci --profile "${REGION_PROFILE}" bv backup-kms-key update --volume-id "${BLOCK_VOLUME_BACKUP_OCID}" --kms-key-id "${MasterEncryptionKey_OCID}"
131131

132132
oci --profile "${REGION_PROFILE}" bv backup update --volume-backup-id "${BLOCK_VOLUME_BACKUP_OCID}" --kms-key-id "${MasterEncryptionKey_OCID}"
133-
echo "${PF1} BLOCK volume backup change from Oracle managed Key to Customer managed Key" >> "${LOG_FILE}"
133+
echo "${PF1} BLOCK volume backup change from Oracle-managed Key to Customer-managed Key" >> "${LOG_FILE}"
134134
fi
135135

136-
color_print "${MYcolor}" "${PF1} Rotation of Customer managed Key"
137-
if [ 1 -eq 1 ] ; then # Rotation of Customer managed Key
136+
color_print "${MYcolor}" "${PF1} Rotation of Customer-managed Key"
137+
if [ 1 -eq 1 ] ; then # Rotation of Customer-managed Key
138138

139139
: ' ---------------------------------------------------------------------------------------------------------------------------------------
140140
Periodically rotating keys limits the amount of data
@@ -144,32 +144,32 @@ kms management key-version create https://docs.oracle.com/
144144
-------------------------------------------------------------------------------------------------------------------------------------------'
145145

146146
oci --profile "${REGION_PROFILE}" kms management key-version create --key-id "${MasterEncryptionKey_OCID}" --endpoint "${ManagementEndpoint}" --wait-for-state "ENABLED"
147-
echo "${PF1} Rotation of Customer managed Key" >> "${LOG_FILE}"
147+
echo "${PF1} Rotation of Customer-managed Key" >> "${LOG_FILE}"
148148
fi
149149

150150
echo "${PF1} --------------------------------------------------------------" >> "${LOG_FILE}"
151151
echo " " >> "${LOG_FILE}"
152152
fi
153153

154-
MYOUTPUT="Secure Storage with Oracle managed Key" && MYCOUNT=$(($MYCOUNT + 1))
154+
MYOUTPUT="Secure Storage with Oracle-managed Key" && MYCOUNT=$(($MYCOUNT + 1))
155155
if [ 1 -eq 1 ] ; then
156156
color_print "${IGreen}" "($MYCOUNT) $(date "+%d.%m.%Y %H:%M:%S") : $MYOUTPUT"
157157

158-
echo "Secure Storage with Oracle managed Key" >> "${LOG_FILE}"
158+
echo "Secure Storage with Oracle-managed Key" >> "${LOG_FILE}"
159159
echo "=====================================================================" >> "${LOG_FILE}"
160160
echo "${PF1} $(date "+%d.%m.%Y %H:%M:%S")" >> "${LOG_FILE}"
161161
echo "${PF1} --------------------------------------------------------------" >> "${LOG_FILE}"
162162

163-
color_print "${MYcolor}" "${PF1} BLOCK volume change from Customer managed Key to Oracle managed Key"
163+
color_print "${MYcolor}" "${PF1} BLOCK volume change from Customer-managed Key to Oracle-managed Key"
164164
if [ 1 -eq 1 ] ; then # BLOCK volume change from Customer managed Key to Oracle managed Key
165165
oci --profile "${REGION_PROFILE}" bv volume-kms-key update --volume-id "${BLOCK_VOLUME_OCID}" --kms-key-id "${MasterEncryptionKey_OCID}"
166-
echo "${PF1} BLOCK volume change from Customer managed Key to Oracle managed Key" >> "${LOG_FILE}"
166+
echo "${PF1} BLOCK volume change from Customer-managed Key to Oracle-managed Key" >> "${LOG_FILE}"
167167
fi
168168

169-
color_print "${MYcolor}" "${PF1} BLOCK volume backup change from Customer managed Key to Oracle managed Key (coming soon)"
170-
if [ 1 -eq 0 ] ; then # BLOCK volume backup change from Customer managed Key to Oracle managed Key (coming soon)
169+
color_print "${MYcolor}" "${PF1} BLOCK volume backup change from Customer-managed Key to Oracle-managed Key (coming soon)"
170+
if [ 1 -eq 0 ] ; then # BLOCK volume backup change from Customer-managed Key to Oracle-managed Key (coming soon)
171171
#oci --profile "${REGION_PROFILE}" bv backup-kms-key update --volume-id "${BLOCK_VOLUME_BACKUP_OCID}" --kms-key-id "${MasterEncryptionKey_OCID}"
172-
echo "${PF1} BLOCK volume backup change from Customer managed Key to Oracle managed Key" >> "${LOG_FILE}"
172+
echo "${PF1} BLOCK volume backup change from Customer-managed Key to Oracle-managed Key" >> "${LOG_FILE}"
173173
fi
174174

175175
echo "${PF1} --------------------------------------------------------------" >> "${LOG_FILE}"
@@ -181,4 +181,4 @@ MYOUTPUT="End of Programm" && MYCOUNT=$(($MYCOUNT + 1))
181181
color_print "${IGreen}" "($MYCOUNT) $(date "+%d.%m.%Y %H:%M:%S") : $MYOUTPUT"
182182
# ---------------------------------------------------------------------------------------------------------------------------------------------
183183
# end of file
184-
# ---------------------------------------------------------------------------------------------------------------------------------------------
184+
# ---------------------------------------------------------------------------------------------------------------------------------------------

‎cloud-infrastructure/storage/block-storage/asset/trim-showcase.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ See [LICENSE](https://github.com/oracle-devrel/technology-engineering/blob/folde
1111

1212
## Prepare your environment
1313
- [Oracle Cloud Infrastructure CLI Command Reference](https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/index.html)
14-
- set up your individual "operate" instance
15-
- 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*)
16-
- create and attach block volume: e.g. trim-test (*200GB*)
14+
- Set up your individual "operate" instance
15+
- 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*).
16+
- Create and attach block volume: e.g. trim-test (*200GB*).
1717

1818
## Format and mount block volume
1919
~~~
@@ -118,10 +118,10 @@ cat "${myLOGFILE}"
118118

119119
## TRIM ON showcase
120120

121-
### Set needed variables (*please adjust variables to your needs before past into your terminal*)
121+
### Set needed variables (*please adjust variables to your needs before past into your terminal*).
122122
~~~
123123
# ---------------------------------------------------------------------------------------------------------------------------------------------
124-
# CUSTOMER SPECIFIC VALUES - please update appropriate
124+
# CUSTOMER SPECIFIC VALUES - Please update appropriate
125125
# ---------------------------------------------------------------------------------------------------------------------------------------------
126126
export TENENCY_OCID=<your_tenency_ocid>
127127
export USER_OCID=<your_user_ocid>

0 commit comments

Comments
 (0)