skyline-console — Interactions

Interactions — skyline-console — branch stable/2026.2

Branch stable/2026.2 @ 806d200392ee — repository https://opendev.org/openstack/skyline-console — analysed on 2026-10-29 Other repositories cited: skyline-apiserver stable/2026.2 @ 4af72bfd4577 (prefix skyline-apiserver:), microversion-parse @ 77ea32a (prefix microversion-parse:), cinder stable/2026.2 @ c117f9cf0 (prefix cinder:), nova stable/2026.2 @ 8df1922926 (prefix nova:).

The console has no database, no message bus and no cache server. Its only interactions are HTTP requests from the browser, all to the same origin as the page, plus two browser-side stores (cookies and localStorage) and the console windows it opens. The full per-service call list, generated from the code, is [_rewrite/outbound-calls_stable-2026.2.md](_rewrite/outbound-calls_stable-2026.2.md) (577 calls reached across 18 services; JSON in _rewrite/outbound-calls_stable-2026.2.json).

1. The request layer

One axios instance per request, created by HttpRequest.buildRequest (src/client/client/request.js:206). axios 0.21.4 (yarn.lock:3172).

URL construction

profile.endpoints values are nginx locations generated by skyline-apiserver: /<nginx_prefix>/<region lower-case>/<service name> (skyline-apiserver:skyline_apiserver/client/openstack/system.py:76), for example /api/openstack/regionone/nova. The nginx location strips the version and %(project_id)s parts of the catalog URL, which the console adds back (skyline-apiserver:skyline_apiserver/cmd/generate_nginx.py:149).

2. Microversion headers

Three tables in src/client/client/constants.js decide the headers; getOpenstackApiVersionForRequest applies them in this order (src/client/client/constants.js:214):

1. Per service, by URL substring (src/client/client/constants.js:90): the first key of nova, placement, cinder, ironic, manila, zun contained anywhere in the URL selects the header. | Key in URL | Header | Value | |---|---|---| | nova | Openstack-Api-Version | compute 2.79 | | placement | Openstack-Api-Version | placement 1.28 | | cinder | Openstack-Api-Version | volume 3.59 | | ironic | X-Openstack-Ironic-Api-Version | 1.58 | | manila | X-OpenStack-Manila-API-Version | 2.55 | | zun | OpenStack-API-Version | container 1.40 |
2. Per action (body with one key, any method): Nova os-migrateLive 2.30, rebuild 2.93, rescue 2.93, lock 2.42, remote_console 2.53; Cinder os-extend 3.60. Header OpenStack-API-Version: <compute|volume> <version> (src/client/client/constants.js:117, src/client/client/constants.js:158).
3. Per URL, GET only: Nova /os-server-groups[/<id>] 2.63; Cinder /messages[/<id>] 3.29 (src/client/client/constants.js:135).

The headers of steps 1 and 2/3 differ only by case (Openstack-Api-Version and OpenStack-API-Version), so the browser merges them into one header with two comma-separated values, base first. Recorded on the wire (Chromium, _rewrite/smoke-exchanges_stable-2026.2.json):

POST /api/openstack/regionone/nova/v2.1/servers/srv1/action
Openstack-Api-Version: compute 2.79, compute 2.42
{"lock": {"locked_reason": "smoke"}}

POST /api/openstack/regionone/cinder/v3/p1/volumes/vol1/action
Openstack-Api-Version: volume 3.59, volume 3.60
{"os-extend": {"new_size": 2}}

GET /api/openstack/regionone/nova/v2.1/os-server-groups
Openstack-Api-Version: compute 2.79, compute 2.63

What the services do with the merged value:

• Nova uses microversion-parse, which reads the values from the last and keeps the first one for its service type: the action version wins (2.42, 2.63, 2.93…) (microversion-parse:microversion_parse/__init__.py:116, nova:nova/api/openstack/wsgi.py:151).
• Cinder splits on , and keeps the first value that contains volume: it always gets 3.59. The 3.60 intended for os-extend and the 3.29 intended for /messages never take effect (cinder:cinder/api/openstack/wsgi.py:292).

Pitfalls of the substring rule: the region name, a service name or any path segment containing nova, cinder, placement, ironic, manila or zun attracts that service's header. With the default service_mapping (skyline-apiserver:skyline_apiserver/config/openstack.py:121) the locations contain the right names (…/nova/…, …/cinder/…, …/manilav2/…). With another mapping (for example compute: compute), no microversion header is sent and Nova answers at 2.1. Then the console breaks on fields it needs (e.g. hypervisor_hostname on create, server tags).

3. Calls to skyline-apiserver

All under /api/openstack/skyline/api/v1/, declared in src/client/skyline/index.js:18. Endpoint definitions are in the apiserver reverse-spec ([../reverse-spec-skyline-apiserver/01-rest-api_stable-2026.2.md](../reverse-spec-skyline-apiserver/01-rest-api_stable-2026.2.md)).

POST policies/check is declared (src/client/skyline/index.js:74) but never called; POST websso is reached by Keystone's form post, not by the console.

4. Calls to the OpenStack APIs (through the nginx proxy)

Calls reached per service (from the generated catalogue; "declared" counts every operation the client table generates):

Patterns worth knowing for any implementation of these APIs:

• Lists: GET <collection> or <collection>/detail with the page's filters. Server-side paging (isFilterByBackend) sends limit, marker, sort_key/sort_dir (Neutron) or sort_keys/sort_dirs (skyline extensions). Other lists fetch everything; fetchListByLimit stores page with limit=100 and the last item's id as marker until a short page (src/stores/base.js:287).
• Admin lists add all_projects=true (src/stores/base.js:360); Cinder backups and Manila use all_tenants instead (src/stores/cinder/backup.js:60, src/stores/manila/share-network.js:41).
• Project names: unknown project_ids in admin lists are fetched one by one with GET /v3/projects/{id} (src/stores/base.js:255).
• Quotas (overview, recorded): GET nova os-quota-sets/{p}/detail, GET cinder os-quota-sets/{p}?usage=True, GET neutron quotas/{p}/details, plus os-keypairs?limit=100 and Cinder types.

Sample frames (recorded against a stand-in, _rewrite/smoke-exchanges_stable-2026.2.json)

POST /api/openstack/skyline/api/v1/login
Content-Type: application/json;charset=UTF-8
X-Openstack-Request-Id: req-fa548f3a-470c-49c3-b50a-b575d5379e84
{"password": "***", "username": "smoke", "domain": "Default"}

GET /api/openstack/regionone/keystone/v3/system/users/u1/roles
X-Auth-Token: <keystone token>
X-Openstack-Request-Id: req-1f2d5c8b-2091-4c04-9cb3-d2fe82a0124c
Cookie: session=<jwt>; time_expired=1793232668

GET /api/openstack/skyline/api/v1/extension/servers?limit=10&sort_keys=created_at&sort_dirs=desc
GET /api/openstack/regionone/neutron/v2.0/networks?project_id=p1&limit=10&sort_key=status&sort_dir=desc
GET /api/openstack/regionone/cinder/v3/p1/os-quota-sets/p1?usage=True   (Openstack-Api-Version: volume 3.59)

5. Outside the proxy

6. Browser-side state

Source: reverse-spec-skyline-console/03-interactions_stable-2026.2.md. The _rewrite/ and _inventory/ files are not published on the site.