https://github.com/gagahsyuja/openstack-walkthrough
A simple guide for getting started with OpenStack Yoga basic deployment on a single node cluster
https://github.com/gagahsyuja/openstack-walkthrough
linux openstack
Last synced: 10 months ago
JSON representation
A simple guide for getting started with OpenStack Yoga basic deployment on a single node cluster
- Host: GitHub
- URL: https://github.com/gagahsyuja/openstack-walkthrough
- Owner: gagahsyuja
- Created: 2025-07-10T10:32:13.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-07-21T04:56:13.000Z (11 months ago)
- Last Synced: 2025-07-21T06:27:28.474Z (11 months ago)
- Topics: linux, openstack
- Homepage: https://www.openstack.org
- Size: 12.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
OpenStack Walkthrough
### A simple guide for getting started with OpenStack Yoga basic deployment on a single node cluster.
# Table of Contents
1. [Learning Resources](#learning-resources)
2. [Requirements](#requirements)
3. [Installation Guide](#installation-guide)
## Learning Resources
- [OpenStack](https://www.openstack.org/) - you can pretty much read this and not this guide
## Requirements
- [VirtualBox](https://www.virtualbox.org) - This guide will occurs mostly on a virtual environment, so a hypervisor is needed. In this example, VirtualBox is used.
- [Ubuntu 22.04 LTS](https://releases.ubuntu.com/focal/) - There's a lot of choice regarding what operating system can be used for OpenStack, but because we are using OpenStack Yoga version, we'll be using Ubuntu and 22.04 LTS to be exact.
- [OpenStack Yoga](https://docs.openstack.org/install-guide/) - As we said before, OpenStack Yoga version are what we are going to be install. So it's best to keep their docs opened alongside this guide.
- [Patience](https://en.wikipedia.org/wiki/Patience) - This is going to be a hell of a ride, so enjoy the ride and take a break if needed!
## Installation Guide
At this point, you should have your Ubuntu 22.04 LTS already installed. And with that done, you can proceed to install OpenStack.
### Network Configuration
Yes, the guide will be starting with configuring the networks, and not installing OpenStack, that will be happened down the road. First of all, there are two kinds of network in OpenStack:
- **Management Network** - Used for internal communication between OpenStack Components. In this case, because only single node is used, then we can use localhost address (127.0.0.1) for our management network.
- **Provider Network** - This network will provide internet access to the OpenStack environment.
With that said, now we need to configure our hosts configuration at `/etc/hosts` to define 127.0.0.1 as controller. Here's how to do it:
```bash
# /etc/hosts
127.0.0.1 localhost
127.0.1.1 localhost
# OpenStack
127.0.0.1 controller
```
Add `127.0.0.1` and assign `controller` as the hostname. If you pay attention to the hosts entry, there is also another IP that assigned to localhost but not `127.0.0.1`, it's instead `127.0.1.1`. Please comment that out or just get rid of it from the hosts file.
```bash
# /etc/hosts
127.0.0.1 localhost
# OpenStack
127.0.0.1 controller
```
Now, hosts file configuration should be looking similarly like above, containing only `localhost` pointing to `127.0.0.1` and `controller` pointing to `127.0.0.1` as well.
Next, we are going to give our Ubuntu install an internet access. So you should have an IP or interface that provides internet, such as NAT, NAT Networks, or even Bridged Adapter. In this case, Bridged Adapter is what we are going to use, but feel free to choose anything else.
After you decided what is going to be used, now you need to configure the netplan configuration file in order to assign those IP to netplan as our internet configuration. Edit `/etc/netplan/50-cloud-init.yaml` as follows:
```bash
# /etc/netplan/50-cloud-init.yml
network:
ethernets:
enp3s0:
dhcp4: yes
```
If you are using NAT or NAT Networks, DHCP will be available so you don't need to manually define what IP address will be used. But if you need to do it, you can assign IP and gateway like so:
```bash
# /etc/netplan/50-cloud-init.yml
network:
ethernets:
enp3s0:
addresses: [ 192.168.x.x/x ]
gateway4: 192.168.x.x
```
With that done, now we can verify if we get an internet by pinging an active domain such as `google.com` or anything else:
```bash
$ ping google.com
PING forcesafesearch.google.com (216.239.38.120) 56(84) bytes of data.
64 bytes from any-in-2678.1e100.net (216.239.38.120): icmp_seq=1 ttl=115 time=28.9 ms
64 bytes from any-in-2678.1e100.net (216.239.38.120): icmp_seq=2 ttl=115 time=27.3 ms
64 bytes from any-in-2678.1e100.net (216.239.38.120): icmp_seq=3 ttl=115 time=27.2 ms
--- forcesafesearch.google.com ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2002ms
rtt min/avg/max/mdev = 27.154/27.768/28.874/0.783 ms
```
If we get a replies and not timed out like above, you can be sure that you got an internet. Congrats.
Next is to check if our controller IP are correct by pinging it directly:
```bash
ping -c 3 controller
PING controller (::1) 56 data bytes
64 bytes from localhost (::1): icmp_seq=1 ttl=64 time=0.082 ms
64 bytes from localhost (::1): icmp_seq=2 ttl=64 time=0.036 ms
64 bytes from localhost (::1): icmp_seq=3 ttl=64 time=0.069 ms
--- controller ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2005ms
rtt min/avg/max/mdev = 0.036/0.062/0.082/0.019 ms
```
Again, if we get a replies then everything is good. Congrats.
Congratulations, network configuration is done and you can proceed to the next steps!
### OpenStack Packages
For other Ubuntu version or edition, you may need to add the repository using `add-apt-repository` to includes OpenStack repository. In the case of Ubuntu 22.04 LTS, it already includes OpenStack Yoga by default, so the only step needed is to install OpenStack Client as the CLI for OpenStack operations that can be installed as follows:
```bash
# apt install python3-openstackclient
```
### SQL Database
OpenStack uses SQL database to store information that runs on controller node. This guide will use MariaDB although PostgreSQL is also supported. Here is how to install it on Ubuntu 22.04 LTS:
```bash
# apt install mariadb-server python3-pymysql
```
After the installation succeed, create and edit `/etc/mysql/mariadb.conf.d/99-openstack.cnf` file to configure the bind-address that will be used for serving MariaDB:
```bash
# /etc/mysql/mariadb.conf.d/99-openstack.cnf
[mysqld]
bind-address = 127.0.0.1
default-storage-engine = innodb
innodb_file_per_table = on
max_connections = 4096
collation-server = utf8_general_ci
character-set-server = utf8
```
Finalize the installation by restarting the database service:
```bash
# systemctl restart mysql
```
And finally, secure the database service by doing `mysql_secure_installation` script. Make sure to choose a reasonable password for the root account:
```bash
mysql_secure_installation
```
### Message Queue
OpenStack uses a message queue to coordinate operations and providing status for all the services connected that runs on the controller node. There are multiple choices of message queue that supported by OpenStack, but in this guide **RabbitMQ** will be used. Start by installing the message queue:
```bash
# apt install rabbitmq-server
```
Now add **openstack** user:
```bash
# rabbitmqctl add_user openstack RABBIT_PASS
```
Replace **RABBIT_PASS** with a suitable password.
Finally, give **openstack** user to permit configuration, write, and read access:
```bash
# rabbitmqctl set_permissions openstack ".*" ".*" ".*"
```
### Memcached
The identity service authentication mechanism for services uses Memcached to cache tokens that runs on the controller node. Start by installing Memcached:
```bash
# apt install memcached python3-memcache
```
If by any chance your management IP address is not `127.0.0.1`, you need to replace the value in `/etc/memcached.conf` file and modify it accordingly:
```bash
-l MANAGEMENT_IP_ADDRESS
```
Replace **MANAGEMENT_IP_ADDRESS** with your management IP address.
Finally, restart the memcached service:
```bash
# systemctl restart memcached
```
### Minimal Deployment
Now is the crucial part, finally we will build what is called as **"stack"**, means stack of services. At a minimum, you need atleast these following services:
- [**Keystone** - Identity service](services/keystone.md)
- [**Glance** - Image service]()
- [**Placement** - Placement service]()
- [**Nova** - Compute service]()
- [**Neutron** - Networking service]()