==============
Vendor Support
==============

OpenStack presents deployers with many options, some of which can expose
differences to end users. `os-client-config` tries its best to collect
information about various things a user would need to know. The following
is a text representation of the vendor related defaults `os-client-config`
knows about.

Default Values
--------------

These are the default behaviors unless a cloud is configured differently.

* Identity uses `password` authentication
* Identity API Version is 2
* Image API Version is 2
* Volume API Version is 2
* Images must be in `qcow2` format
* Images are uploaded using PUT interface
* Public IPv4 is directly routable via DHCP from Neutron
* IPv6 is not provided
* Floating IPs are not required
* Floating IPs are provided by Neutron
* Security groups are provided by Neutron
* Vendor specific agents are not used

auro
----

https://api.auro.io:5000/v2.0

============== ================
Region Name    Location
============== ================
van1           Vancouver, BC
============== ================

* Public IPv4 is provided via NAT with Neutron Floating IP

betacloud
---------

https://api-1.betacloud.io:5000

============== ==================
Region Name    Location
============== ==================
betacloud-1    Nuremberg, Germany
============== ==================

* Identity API Version is 3
* Images must be in `raw` format
* Public IPv4 is provided via NAT with Neutron Floating IP
* Volume API Version is 3

catalyst
--------

https://api.cloud.catalyst.net.nz:5000/v2.0

============== ================
Region Name    Location
============== ================
nz-por-1       Porirua, NZ
nz_wlg_2       Wellington, NZ
============== ================

* Image API Version is 1
* Images must be in `raw` format
* Volume API Version is 1

citycloud
---------

https://identity1.citycloud.com:5000/v3/

============== ================
Region Name    Location
============== ================
Buf1           Buffalo, NY
Fra1           Frankfurt, DE
Kna1           Karlskrona, SE
La1            Los Angeles, CA
Lon1           London, UK
Sto2           Stockholm, SE
============== ================

* Identity API Version is 3
* Public IPv4 is provided via NAT with Neutron Floating IP
* Volume API Version is 1

conoha
------

https://identity.%(region_name)s.conoha.io

============== ================
Region Name    Location
============== ================
tyo1           Tokyo, JP
sin1           Singapore
sjc1           San Jose, CA
============== ================

* Image upload is not supported

datacentred
-----------

https://compute.datacentred.io:5000

============== ================
Region Name    Location
============== ================
sal01          Manchester, UK
============== ================

* Image API Version is 1

dreamcompute
------------

https://iad2.dream.io:5000

============== ================
Region Name    Location
============== ================
RegionOne      Ashburn, VA
============== ================

* Identity API Version is 3
* Images must be in `raw` format
* IPv6 is provided to every server

dreamhost
---------

Deprecated, please use dreamcompute

https://keystone.dream.io/v2.0

============== ================
Region Name    Location
============== ================
RegionOne      Ashburn, VA
============== ================

* Images must be in `raw` format
* Public IPv4 is provided via NAT with Neutron Floating IP
* IPv6 is provided to every server

otc
---

https://iam.%(region_name)s.otc.t-systems.com/v3

============== ================
Region Name    Location
============== ================
eu-de          Germany
============== ================

* Identity API Version is 3
* Images must be in `vhd` format
* Public IPv4 is provided via NAT with Neutron Floating IP

elastx
------

https://ops.elastx.net:5000/v2.0

============== ================
Region Name    Location
============== ================
regionOne      Stockholm, SE
============== ================

* Public IPv4 is provided via NAT with Neutron Floating IP

entercloudsuite
---------------

https://api.entercloudsuite.com/v2.0

============== ================
Region Name    Location
============== ================
nl-ams1        Amsterdam, NL
it-mil1        Milan, IT
de-fra1        Frankfurt, DE
============== ================

* Image API Version is 1
* Volume API Version is 1

fuga
----

https://identity.api.fuga.io:5000

============== ================
Region Name    Location
============== ================
cystack        Netherlands
============== ================

* Identity API Version is 3
* Volume API Version is 3

internap
--------

https://identity.api.cloud.iweb.com/v2.0

============== ================
Region Name    Location
============== ================
ams01          Amsterdam, NL
da01           Dallas, TX
nyj01          New York, NY
sin01          Singapore
sjc01          San Jose, CA
============== ================

* Floating IPs are not supported

ovh
---

https://auth.cloud.ovh.net/v2.0

============== ================
Region Name    Location
============== ================
BHS1           Beauharnois, QC
SBG1           Strassbourg, FR
GRA1           Gravelines, FR
============== ================

* Images may be in `raw` format. The `qcow2` default is also supported
* Floating IPs are not supported

rackspace
---------

https://identity.api.rackspacecloud.com/v2.0/

============== ================
Region Name    Location
============== ================
DFW            Dallas, TX
HKG            Hong Kong
IAD            Washington, D.C.
LON            London, UK
ORD            Chicago, IL
SYD            Sydney, NSW
============== ================

* Database Service Type is `rax:database`
* Compute Service Name is `cloudServersOpenStack`
* Images must be in `vhd` format
* Images must be uploaded using the Glance Task Interface
* Floating IPs are not supported
* Public IPv4 is directly routable via static config by Nova
* IPv6 is provided to every server
* Security groups are not supported
* Uploaded Images need properties to not use vendor agent::
  :vm_mode: hvm
  :xenapi_use_agent: False
* Volume API Version is 1
* While passwords are recommended for use, API keys do work as well.
  The `rackspaceauth` python package must be installed, and then the following
  can be added to clouds.yaml::

    auth:
      username: myusername
      api_key: myapikey
    auth_type: rackspace_apikey

switchengines
-------------

https://keystone.cloud.switch.ch:5000/v2.0

============== ================
Region Name    Location
============== ================
LS             Lausanne, CH
ZH             Zurich, CH
============== ================

* Images must be in `raw` format
* Images must be uploaded using the Glance Task Interface
* Volume API Version is 1

ultimum
-------

https://console.ultimum-cloud.com:5000/v2.0

============== ================
Region Name    Location
============== ================
RegionOne      Prague, CZ
============== ================

* Volume API Version is 1

unitedstack
-----------

https://identity.api.ustack.com/v3

============== ================
Region Name    Location
============== ================
bj1            Beijing, CN
gd1            Guangdong, CN
============== ================

* Identity API Version is 3
* Images must be in `raw` format
* Volume API Version is 1

vexxhost
--------

http://auth.vexxhost.net

============== ================
Region Name    Location
============== ================
ca-ymq-1       Montreal, QC
============== ================

* DNS API Version is 1
* Identity API Version is 3

zetta
-----

https://identity.api.zetta.io/v3

============== ================
Region Name    Location
============== ================
no-osl1        Oslo, NO
============== ================

* DNS API Version is 2
* Identity API Version is 3
