fix integration tests, add epoxy release (#428)

* use `cinder/block-storage` service instead of `cinderv3/volumev3` in tests

Author: k0ka

.github/workflows/integration_tests.yml

@@ -2,6 +2,16 @@ name: Integration Tests
 
 on:
   workflow_dispatch:
+    inputs:
+      tmate_enabled:
+        type: boolean
+        description: 'Run the build with tmate debugging enabled'
+        required: false
+        default: false
+      openstack_version:
+        description: 'Comma-separated list of Openstack versions e.g. "stable/2025.1", "unmaintained/zed"'
+        required: false
+        default: false
   pull_request:
   push:
     branches:
@@ -19,23 +29,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        openstack_version: [ "stable/2023.2" ]
+        openstack_version: ${{ fromJSON(format('[{0}]', inputs.openstack_version || vars.OPENSTACK_VERSIONS )) }}
         php_version: [ 8.1 ]
-        include:
-          - name: "dalmatian"
-            openstack_version: "stable/2024.2"
-            ubuntu_version: "22.04"
-          - name: "caracal"
-            openstack_version: "stable/2024.1"
-            ubuntu_version: "22.04"
-          - name: "antelope"
-            openstack_version: "unmaintained/2023.1"
-            ubuntu_version: "22.04"
-          - name: "zed"
-            openstack_version: "unmaintained/zed"
-            ubuntu_version: "22.04"
+        ubuntu_version: [ 22.04 ]
     runs-on: ubuntu-${{ matrix.ubuntu_version }}
-    name: Deploy OpenStack ${{ matrix.name }} and run integration tests with php ${{matrix.php_version}}
+    name: Deploy OpenStack ${{ matrix.openstack_version }} and run integration tests with php ${{matrix.php_version}}
     steps:
       - uses: actions/checkout@v4
 
@@ -120,3 +118,7 @@ jobs:
         with:
           name: failure-logs-${{ strategy.job-index }}
           path: failure-logs
+
+      - name: Setup tmate session
+        uses: mxschmitt/action-tmate@v3
+        if: ${{ always() && github.event_name == 'workflow_dispatch' && inputs.tmate_enabled }}

doc/services/block-storage/v3/index.rst

@@ -4,6 +4,13 @@ Block Storage v3
 OpenStack Block Storage API v3 (Cinder). Cinder is the OpenStack Block Storage service for providing volumes
 to Nova virtual machines, Ironic bare metal hosts, containers and more.
 
+.. note::
+
+    By default we are creating Cinder service with ``cinderv3`` name and ``volumev3`` type.
+    This is left for backward compatibility and would be changed on the next major release of OpenStack SDK.
+    It's made to be compatible with the old OpenStack installations where the 2nd version of Cinder was also installed.
+    Check your service name and type. New installations would use ``cinder`` name and ``block-storage`` type.
+
 .. osdoc:: https://docs.openstack.org/api-ref/block-storage/v3/
 
 .. toctree::

samples/BlockStorage/v3/snapshots/create.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshot = $service->createSnapshot([
     'volumeId'    => '{volumeId}',

samples/BlockStorage/v3/snapshots/delete.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshot = $service->getSnapshot('{snapshotId}');
 $snapshot->delete();

samples/BlockStorage/v3/snapshots/get.php

@@ -9,6 +9,6 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshot = $service->getSnapshot('{snapshotId}');

samples/BlockStorage/v3/snapshots/get_metadata.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $metadata = $service->getSnapshot('{snapshotId}')
                     ->getMetadata();

samples/BlockStorage/v3/snapshots/list.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshots = $service->listSnapshots();
 

samples/BlockStorage/v3/snapshots/list_detail.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshots = $service->listSnapshots(true);
 

samples/BlockStorage/v3/snapshots/list_sorted.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshots = $service->listSnapshots(false, ['sortKey' => '{sortKey}', 'sortDir' => '{sortDir}']);
 

samples/BlockStorage/v3/snapshots/merge_metadata.php

@@ -9,7 +9,7 @@
     'scope'   => ['project' => ['id' => '{projectId}']]
 ]);
 
-$service = $openstack->blockStorageV3();
+$service = $openstack->blockStorageV3(['catalogName' => 'cinder', 'catalogType' => 'block-storage']);
 
 $snapshot = $service->getSnapshot('{snapshotId}');