.gitignore

+# Compiled book
+/_book/
+
+# Build deps
+/node_modules/

.gitlab-ci.yml

+# requiring the environment of NodeJS 10
+image: node:10
+
+# add 'node_modules' to cache for speeding up builds
+cache:
+  paths:
+    - node_modules/ # Node modules and dependencies
+
+before_script:
+  - apt-get update && apt-get -y install calibre # needed for conversion to PDF
+  - npm install gitbook-cli -g # install gitbook
+  - gitbook fetch 3.2.3 # fetch final stable version
+  - gitbook install # add any requested plugins in book.json
+
+# the 'pages' job will deploy and build your site to the 'public' path
+pages:
+  stage: deploy
+  script:
+    - gitbook build . public                  # build to public path
+    - gitbook pdf . public/mcc-user-guide.pdf # add PDF version
+  artifacts:
+    paths:
+      - public
+    expire_in: 1 week
+  only:
+    - master # this job will affect only the 'master' branch

0-quick-start/README.md

+# Quick Start
+
+## Sign In
+
+The dashboard is available at [https://dashboard.cloud.muni.cz](https://dashboard.cloud.muni.cz).
+
+1. Select `EINFRA CESNET`.
+
+  <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+    <strong>Notice:</strong><br/>
+    Users of the Czech national e-infrastructure should always select <strong>EINFRA CESNET</strong>.
+    International users may choose <strong>EGI Check-in</strong> or <strong>ELIXIR AAI</strong>, depending on
+    their membership.
+  </div>
+
+2. Click on **Sign In**.
+
+  ![](/0-quick-start/images/sign_in1.png)
+
+3. Select your institution from the drop-down list.
+
+   <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+     <strong>Notice:</strong><br/>
+     You can use the search box at the top as a filter.
+   </div>
+
+4. Provide your institution-specific sign-in credentials.
+5. Wait to be redirected back to our dashboard.
+
+  <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+    <strong>Notice:</strong><br/>
+    If your attempts repeatedly result in an error message about projects, make sure you have an active MetaCentrum account
+    and that you are selecting the correct institution when attempting to log in. If the problem persists, please, contact user
+    support.
+  </div>
+
+## Create Key Pair
+
+All virtual machine instances running in the cloud have to be accessed remotely. The most common way of accessing
+an instance remotely is SSH. Using SSH requires a pair of keys - a public key and a private key.
+
+1. In **Project &gt; Compute &gt; Key Pairs**, click the **Create Key Pair** button.
+
+  ![](/0-quick-start/images/CreateKeyPair1.png)
+
+2. Name your key. Avoid using special characters, if possible.
+
+  ![](/0-quick-start/images/CreateKeyPair2.png)
+
+3. You can see your newly created key pair and its fingerprint. We recommend you store the key in
+   a safe location and back it up in case you accidentally delete it.
+
+  ![](/0-quick-start/images/CreateKeyPair3.png)
+
+## Update Security Group
+
+In OpenStack, all incoming traffic from external networks to virtual machine instances is blocked by default.
+You need to explicitly allow access to virtual machine instances and services via a security group.
+
+You need to add two new rules to be able to connect to your new instance (or any instance using the given security group).
+This is similar to setting up firewall rules on your router or server. If set up correctly, you will be able to access
+your virtual machine via SSH from your local terminal.
+
+1. Go to **Project &gt;  Network &gt; Security Groups**. Click on **Manage Rules**, for the **default** security group.
+
+  ![](/0-quick-start/images/SecurityGroups1.png)
+
+2. Click on **Add rule**, choose **SSH** and leave the remaining fields unchanged.
+   This will allow you to access your instance.
+
+  ![](/0-quick-start/images/SecurityGroups2.png)
+
+3. Click on **Add rule**, choose **ALL ICMP** and leave the remaining fields unchanged.
+   This will allow you to `ping` your instance.
+
+  ![](/0-quick-start/images/SecurityGroups3.png)
+
+## Create Virtual Machine Instance
+
+1. In **Compute &gt; Instances**, click the **Launch Instance** button.
+
+  ![](/0-quick-start/images/instance0.png)
+
+2. Choose name, description, and the number of instances.
+   If you are creating more instances, `-%i` will be automatically appended to the name of each instance.
+
+  ![](/0-quick-start/images/instance1.png)
+
+3. Choose an image from which to boot the instance. Image will be automatically copied to a persistent volume
+   that will remain available even after the instance has been deleted.
+
+  ![](/0-quick-start/images/instance2.png)
+
+4. Choose the size of your instance by selecting a flavor. Additional volumes for data can be attached later on.
+
+  ![](/0-quick-start/images/instance3.png)
+
+5. __(optional)__ On the Configuration tab, you can use `user_data` to customize your instance at boot.
+   See [cloud-init](https://cloud-init.io/) for details.
+
+## Associate Floating IP
+
+To make an instance accessible from external networks (e.g., The Internet), a so-called Floating IP Address has to be
+associated with it.
+
+1. In **Project &gt; Network &gt; Floating IPs**, select **Allocate IP to Project**. Pick an IP pool from which to allocate
+   the address. Click on **Allocate IP**.
+
+   <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+     <strong>Notice:</strong><br/>
+     When picking an IP pool from which to allocate a floating IP address, please, keep in mind that you have to allocate
+     an address in the pool connected to your virtual router. For automatically allocated routers, this means `public-muni-147-251-124`.
+   </div>
+
+   <div style="border-width:0;border-left:5px solid #b8d6f4;background-color:rgba(228,240,251,0.3);margin:20px 0;padding:10px 20px;font-size:15px;">
+     <strong>Notice:</strong><br/>
+     Please, keep an eye on the number of allocated IPs in <strong>Project &gt; Network &gt; Floating IPs</strong>. IPs
+     remain allocated to you until you explicitly release them in this tab. Detaching an IP from an instance is not sufficient
+     and the IP in question will remain allocated to you and consume your Floating IP quota.
+   </div>
+
+1. In **Project &gt; Compute &gt; Instances**, select **Associate Floating IP** from the **Actions** drop-down menu for the
+   given instance.
+
+2. Select IP address and click on **Associate**.
+
+  ![](/0-quick-start/images/allocate_IP3.png)
+
+## Create Volume
+
+When storing a large amount of data in a virtual machine instance, it is advisable to use a separate volume and not the
+root file system containing the operating system. It adds flexibility and often prevents data loss. Volumes can be
+attached and detached from instances at any time, their creation and deletion are managed separately from instances.
+
+1. In **Project &gt; Volumes &gt; Volumes**, select **Create Volume**.
+2. Provide name, description and size in GBs. If not instructed otherwise, leave all other fields unchanged.
+3. Click on **Create Volume**.
+4. __(optional)__ In **Project &gt; Compute &gt; Instances**, select **Attach Volume** from the **Actions** drop-down menu for the
+   given instance.
+5. __(optional)__ Select **Volume ID** from the drop-down list and click **Attach Volume**.