Skip to content

Commit

Permalink
Merge branch 'main' into feat/k8s_e2e_resources
Browse files Browse the repository at this point in the history
  • Loading branch information
frosty-geek authored Aug 9, 2023
2 parents 4eae0bf + 7d9097e commit 8e45feb
Show file tree
Hide file tree
Showing 4 changed files with 832 additions and 13 deletions.
4 changes: 3 additions & 1 deletion community/cloud-resources/cloud-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,6 @@ Service users will have their default_project_id set to a specific project and w
| Unique Identifier | Project Name | Community Contact | Description | Needed until |
| :------------------------------: | --------------------------- | ----------------- | --------------------------------- | :----------: |
| 2237c767cf5f456da19359ed31c1c16b | p500924-scs-community | fkr | SCS Community Project ||
| e7ee61b62ecc417199b154ae4218f25f | p500924-beermann | tibeer | Project of Tim Beermann, OSISM ||
| b43cfafbcf1f4eb08865b2886c29e09b | p500924-cluster-api-session | garloff | cluster-api hands on session ||
| 9b7a73e516be4cd1acbd63d543985c52 | p500924-gonicus-dev | o-otte | GONICUS GmbH ||
| 3829cc7c8f034fc985f5055a1df6f247 | p500924-scs-healthmonitor | garloff | SCS Health Monitor ||
Expand All @@ -60,6 +59,9 @@ Service users will have their default_project_id set to a specific project and w
| 91091d4039a6457db27d48d58bb1b4e4 | p500924-jschoone | jschoone | KaaS dev and evaluation ||
| 93956190702b4a7d8a8886806d57713f | p500924-metering | cah-link | Metering Dev Project | 31.12.2023 |
| abbe6561cf6248b6af395334aa09af85 | p500924-harbor | chess-knight | Project for Harbor deployment ||
| 4ff97734574146ccb4c7e7568bc1e36f | p500924-XPanse | swaroopar | Eclipse XPanse Projekt POC | 31.11.2023 |
| e7622c1048ac4520a2d050ae141e826b | p500924-tender-6a | jschoone | Dev Environment for VP06a ||
| eeed7e0ad33f42f189fb4165116f5a1b | p500924-dnation-k8s | matofeder | dNation K8s Dev Project ||
| | | | | |

## Wavecon
Expand Down
110 changes: 98 additions & 12 deletions community/cloud-resources/getting-started-openstack.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,88 @@
---
title: Getting Started with OpenStack
version: 2023-03-02
author: Ralf Heiringhoff, Eduard Itrich
version: 2023-08-04
author: Ralf Heiringhoff, Eduard Itrich, Mathias Fechner
---

## Getting Started with OpenStack CLI

## OpenStackClient (CLI)

The OpenStackClient is installable via all major Linux Distibitions (`apt search openstackclient`)
or directly via [pypi](https://pypi.org/project/python-openstackclient). For
further Information see the OpenStack Project upstream website
The OpenStackClient is installable via all major Linux Distributions:

for debian and ubuntu with apt:

```bash
sudo apt install python3-openstackclient
```

for ubuntu with snap openstack CLI is installable too:

```bash
sudo snap install openstackclients
```

>[!NOTE]
>Versions from Linux repository could be in a stable but old state.
Install it directly via [pypi](https://pypi.org/project/python-openstackclient)
from upstream is the recommend way.

Here for example RHEL:

```bash
sudo dnf install python3 python3-devel gcc python3-pip
```

Here for example Debian and Ubuntu:

```bash
sudo apt install python3-minimal python3-pip python3-venv python3-dev build-essential
```

Here as example for SUSE

```bash
sudo zypper in python3-pip python3-venv python3-dev
```

Here for example with Apple's MacOS

```bash
brew install python3
```

>[!NOTE]
>Python installation for windows systems please use the [python installation guide](https://www.python.org/downloads/windows/)
>or recommend use the [Linux Subsystem WSL](https://learn.microsoft.com/de-de/windows/wsl/install)
Python Virtualenv

It is also recommended to use virtual environments, here as an example for
Linux and MacOS:

```bash
python3 -m venv oscli
source oscli/bin/activate
pip install --upgrade pip
pip install python-openstackclient \
python-cinderclient \
python-designateclient \
python-glanceclient \
python-neutronclient \
python-novaclient \
python-octaviaclient \
python-barbicanclient

```

For further Information see the OpenStack Project upstream website
[python-openstackclient](https://docs.openstack.org/python-openstackclient/latest/index.html).

This repo holds examples for [clouds-public.yaml](clouds-public.yaml) + [clouds.yaml](clouds.yaml.sample).

Alternatively you can download an OpenRC Environment file when you're logged in to Horizon:
Alternatively you can download an OpenRC Environment file when you're logged
in to Horizon:

- upper right side :arrow_right: `<your login name>`
- OpenStack RC File
Expand All @@ -25,16 +92,35 @@ $ source ./<your file>-openrc.sh
Please enter your OpenStack Password for project XXX as user YYY:
```

when you're using clouds.yaml you can specify multiple endpoints and select the specific endpoint
by passing `--os-cloud=` to the openstack cmdline or setting `OS_CLOUD`.
```bash
openstack --help
```

when you're using clouds.yaml you can specify multiple endpoints and
select the specific endpoint by passing `--os-cloud=` to the
openstack cmdline or setting `OS_CLOUD`.

```bash
openstack --os-cloud MYCLOUD
```

or

```bash
export OS_CLOUD=MYCLOUD
openstack
```

OpenStack Client in action inside of the OSISM testbed:
![Example OpenStackClient in testbed](getting_started_openstack_anim.gif)

## Object Storage (S3)

Create AWS like credentials with `openstack ec2 credentials create`.
If you use libs3, store the access field in `S3_ACCESS_KEY_ID` and the secret field in
`S3_SECRET_ACCESS_KEY` and set `S3_HOSTNAME=<Object Storage endpoint>`.
You will see the same buckets (containers) and objects whether you access your object store
via the swift or via the s3 protocol.
If you use libs3, store the access field in `S3_ACCESS_KEY_ID` and the secret
field in`S3_SECRET_ACCESS_KEY` and set `S3_HOSTNAME=<Object Storage endpoint>`.
You will see the same buckets (containers) and objects whether you access your
object store via the swift or via the s3 protocol.

## References

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 8e45feb

Please sign in to comment.