# Kolla Ansible Deployment

## Environments

> **Requirements:**\
> 2 network interfaces\
> 8GB main memory\
> 100GB disk space\
> ubuntu20.04 / centos8

- kolla : `https://github.com/openstack/kolla`
- kolla-ansible : `https://github.com/openstack/kolla-ansible`

## kolla build docker image

- If kolla is not installed in the deployment environment

  ```shell
  cd /opt
  git clone https://github.com/openstack/kolla-ansible
  cd /opt/kolla-ansible
  sudo pip3 install /opt/kolla-ansible
  ```

### Build skyline image

> **Note : Only provide ubuntu-source-skyline of skyline image**

- `-b`: The distro type of the base image
- `-t`: The method of the OpenStack install
- `-n`: The Docker namespace name
- `--tag`: Docker tag
- `--registry`: The docker registry host
- `--push`: Push images after building

```shell
kolla-build -b ubuntu -t source -n kolla --tag master --registry 127.0.0.1:4000 --push skyline
```

## Kolla Ansible Install

### kolla-ansible install

- If kolla-ansible is not installed in the deployment environment

  ```shell
  cd /opt
  git clone https://github.com/openstack/kolla-ansible
  cd /opt/kolla-ansible
  sudo pip3 install /opt/kolla-ansible
  ```

### Configuration

- If the configuration file does not exist(globals.yml/passwords.yml/all-in-one/multinode), copy the
  configuration files and generate passwords

  ```shell
  cp -r kolla-ansible/etc/kolla/* /etc/kolla
  cp kolla-ansible/ansible/inventory/* /etc/kolla
  kolla-genpwd
  ```

- If the configuration file exists(globals.yml/passwords.yml/all-in-one/multinode), modify it
  manually
  - Edit `/etc/kolla/all-in-one` and `/etc/kolla/multinode`, add the following options

    ```bash
    [skyline:children]
    control
    ```

  - Edit `/etc/kolla/passwords.yml` and add the following options, then generate passwords manually
    or by running `kolla-genpwd`

    ```shell
    skyline_database_password:
    skyline_keystone_password:
    ```

Edit `/etc/ansible/ansible.cfg` file

```bash
[defaults]
host_key_checking=False
pipelining=True
forks=100
```

Edit `/etc/kolla/globals.yml` file, for example:

```bash
network_interface: "eth0"
neutron_external_interface: "eth1"
kolla_internal_vip_address: "192.168.10.250"
enable_skyline: "yes"
docker_registry: "127.0.0.1:4000"
docker_namespace: "kolla"
kolla_base_distro: "ubuntu"
kolla_install_type: "source"
```

### Skyline Deployment

> **Note : Openstack basic modules have been installed**

```shell
kolla-ansible -i ./all-in-one bootstrap-servers -t skyline
kolla-ansible -i ./all-in-one prechecks -t skyline
kolla-ansible -i ./all-in-one deploy -t skyline
```

## FAQ

### Local Repository Error "connect: Connection refused" occurred during skyline image build and skyline deployment

Edit `/etc/docker/daemon.json` file and Delete the following options

```shell
bridge: "none"
```

Restart docker service

```shell
sudo service docker restart
```

Run local registry

```shell
docker run -d --name registry --restart=always -p 4000:5000 -v registry:/var/lib/registry registry:2
```