====== py-glance ======

| [[https://www.freshports.org/misc/py-glance|misc/py-glance]] |

//%%OpenStack%% Image Server//

===== Set up Glance on FreeBSD =====

==== Prerequisites ====

  * a configured and working instance of [[https://www.freshports.org/security/py-keystone|security/py-keystone]]
  * [[https://www.freshports.org/net/py-python-openstackclient|net/py-python-openstackclient]] is required for the setup and administration tasks
  * a decent amount of space for the location where all images will be saved. The default location is **/var/lib/glance/images**.

==== Prepare the system ====

The following commands must be run as the %%OpenStack%% admin user. (It is assumed that the environment (OS_AUTH_URL, OS_PASSWORD, etc.) is already set thus the subsequent commands are listed only with the required parameters for the sake of brevity.)

=== Create the user, role and service ===

<code>
$ openstack user create --domain default --password-prompt glance
$ openstack role add --project service --user glance admin
$ openstack service create --name glance --description "OpenStack Image" image
</code>

=== Create the endpoints ===

<code>
$ openstack endpoint create --region RegionOne image public http://glancehost:9292
$ openstack endpoint create --region RegionOne image internal http://glancehost:9292
$ openstack endpoint create --region RegionOne image admin http://glancehost:9292
</code>

==== Configure the Glance service ====

The following files must be configured:

  * /usr/local/etc/glance/glance-api.conf
  * /usr/local/etc/glance/glance-registry.conf
  * /usr/local/etc/glance/glance-scrubber.conf

=== glance-api.conf ===

<code>
[database]
# ...
# Please make sure that you use an absolute path otherwise Glance won't work properly.
connection = sqlite:////var/lib/glance/glance.db

[keystone_authtoken]
# ...
auth_uri = http://keystonehost:5000
auth_url = http://keystonehost:5000
auth_type = password
project_domain_name = Default
user_domain_name = Default
project_name = service
username = glance
password = GLANCE_PASS

[paste_deploy]
# ...
flavor = keystone

[glance_store]
# ...
stores = file,http
default_store = file
# Ensure that this location has enough space!
filesystem_store_datadir = /var/lib/glance/images/
</code>

=== glance-registry.conf ===

<code>
[database]
# ...
# Please make sure that you use an absolute path otherwise Glance won't work properly.
connection = sqlite:////var/lib/glance/glance.db

[keystone_authtoken]
# ...
auth_uri = http://keystonehost:5000
auth_url = http://keystonehost:5000
auth_type = password
project_domain_name = Default
user_domain_name = Default
project_name = service
username = glance
password = GLANCE_PASS

[paste_deploy]
# ...
flavor = keystone
</code>

=== glance-scrubber.conf ===

<code>
[DEFAULT]
# ...
daemon = yes

[glance_store]
# ...
stores = file,http
default_store = file
# Ensure that this location has enough space!
filesystem_store_datadir = /var/lib/glance/images/
</code>

==== Populate the Image service database ====

<code>
# su -m glance -c "glance-manage db_sync"
</code>

==== Enable the services ====

Enable and start the Glance services:

  * glance-api
  * glance-registry
  * glance-scrubber

==== Verify operation ====

<code>
$ fetch https://download.freebsd.org/ftp/releases/VM-IMAGES/11.2-RELEASE/amd64/Latest/FreeBSD-11.2-RELEASE-amd64.qcow2.xz
$ unxz FreeBSD-11.2-RELEASE-amd64.qcow2.xz
$ openstack image create "freebsd-11.2-amd64" --file FreeBSD-11.2-RELEASE-amd64.qcow2 --disk-format qcow2 --container-format bare
</code>

===== References =====
[[https://docs.openstack.org/glance/queens/install/index.html]]

----

{{tag>HowTo Ports}}