From 987d195aba2bd44cd16a2bdefa924f5668db8d5e Mon Sep 17 00:00:00 2001
From: Marco Emilio Poleggi <marco-emilio.poleggi@hesge.ch>
Date: Tue, 6 Dec 2022 11:16:56 +0100
Subject: [PATCH] More SE/OpenStack doc

---
 SwitchEngines/README.md                         |  12 ++++++++----
 ...jetc-zone_Screenshot_2022-12-06_11-05-02.png | Bin 0 -> 21820 bytes
 2 files changed, 8 insertions(+), 4 deletions(-)
 create mode 100644 SwitchEngines/figures/SE_projetc-zone_Screenshot_2022-12-06_11-05-02.png

diff --git a/SwitchEngines/README.md b/SwitchEngines/README.md
index 7d66f3a..cc82506 100644
--- a/SwitchEngines/README.md
+++ b/SwitchEngines/README.md
@@ -3,8 +3,8 @@
 Lab template for a Cloud provisioning/orchestration exercise with Terraform
 (TF) and SwitchEngines (OpenStack).
 
-:bulb: OpenStack is an open-source Cloud management platform. Although we use here 
-the SwitchEngines provider, the instructions should be valid for any other Cloud 
+:bulb: OpenStack is an open-source Cloud management platform. Although we use here
+the SwitchEngines provider, the instructions should be valid for any other Cloud
 provider that employs OpenStack.
 
 
@@ -39,7 +39,7 @@ Please, refer to your OS documentation for the proper way to do so.
      CLI](https://docs.openstack.org/newton/user-guide/common/cli-install-openstack-command-line-clients.html)
      version >= 6.0.0. It is recommended to install your original distribution
      package named like `python-openstackclient`.
-  1. :bulb: **Skip this step if you already have a project assigned in SwitchEngines.** 
+  1. :bulb: **Skip this step if you already have a project assigned in SwitchEngines.**
      On the OpenStack "Horizon" dashboard, create a new project. The placeholder used in
      this exercise is `<your-project-name>`.
   1. :bulb: **Skip this step if you already have your project's application credentials.**
@@ -71,7 +71,11 @@ Please, refer to your OS documentation for the proper way to do so.
 
 **Goal:** instruct TF to handle a single OpenStack instance.
 
-:bulb: Mind that the SwitchEngines' default _zone_ is "ZH", as it is shown in the top bar of the Horizon dashboard.
+:bulb: Mind that the SwitchEngines' default _zone_ is "ZH", as it is shown in
+the top bar of the Horizon dashboard:
+
+![SwitchEngines project/zone selection](figures/SE_projetc-zone_Screenshot_2022-12-06_11-05-02.png)
+
 Make sure that the same zone is configured in your `clouds.yaml`:
 
 ```yaml
diff --git a/SwitchEngines/figures/SE_projetc-zone_Screenshot_2022-12-06_11-05-02.png b/SwitchEngines/figures/SE_projetc-zone_Screenshot_2022-12-06_11-05-02.png
new file mode 100644
index 0000000000000000000000000000000000000000..4149c98234440d1e2a20105f90a1ba6d246cba58
GIT binary patch
literal 21820
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

literal 0
HcmV?d00001

-- 
GitLab