summaryrefslogtreecommitdiff
path: root/doc/rtd
diff options
context:
space:
mode:
authorahosmanmsft <ahosman@microsoft.com>2019-11-26 11:36:00 -0700
committerChad Smith <chad.smith@canonical.com>2019-11-26 11:36:00 -0700
commitaa3e4961ceae5a5c5b5cf13221b5f6721991fe75 (patch)
tree43bcc20bbdeeb44e02911dfb55759377f8aa1a5c /doc/rtd
parentb6055c40189afba323986059434b8d8adc85bba3 (diff)
downloadvyos-cloud-init-aa3e4961ceae5a5c5b5cf13221b5f6721991fe75.tar.gz
vyos-cloud-init-aa3e4961ceae5a5c5b5cf13221b5f6721991fe75.zip
cloud_tests: add azure platform support to integration tests
Added Azure to cloud tests supporting upstream integration testing. Implement the inherited platform classes, Azure configurations to release/platform, and docs on how to run Azure CI.
Diffstat (limited to 'doc/rtd')
-rw-r--r--doc/rtd/topics/tests.rst52
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/rtd/topics/tests.rst b/doc/rtd/topics/tests.rst
index a2c703a5..3b27f805 100644
--- a/doc/rtd/topics/tests.rst
+++ b/doc/rtd/topics/tests.rst
@@ -423,6 +423,58 @@ generated when running ``aws configure``:
region = us-west-2
+Azure Cloud
+-----------
+
+To run on Azure Cloud platform users login with Service Principal and export
+credentials file. Region is defaulted and can be set in ``tests/cloud_tests/platforms.yaml``.
+The Service Principal credentials are the standard authentication for Azure SDK
+to interact with Azure Services:
+
+Create Service Principal account or login
+
+.. code-block:: shell-session
+
+ $ az ad sp create-for-rbac --name "APP_ID" --password "STRONG-SECRET-PASSWORD"
+
+.. code-block:: shell-session
+
+ $ az login --service-principal --username "APP_ID" --password "STRONG-SECRET-PASSWORD"
+
+Export credentials
+
+.. code-block:: shell-session
+
+ $ az ad sp create-for-rbac --sdk-auth > $HOME/.azure/credentials.json
+
+.. code-block:: json
+
+ {
+ "clientId": "<Service principal ID>",
+ "clientSecret": "<Service principal secret/password>",
+ "subscriptionId": "<Subscription associated with the service principal>",
+ "tenantId": "<The service principal's tenant>",
+ "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
+ "resourceManagerEndpointUrl": "https://management.azure.com/",
+ "activeDirectoryGraphResourceId": "https://graph.windows.net/",
+ "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
+ "galleryEndpointUrl": "https://gallery.azure.com/",
+ "managementEndpointUrl": "https://management.core.windows.net/"
+ }
+
+Set region in platforms.yaml
+
+.. code-block:: yaml
+ :emphasize-lines: 3
+
+ azurecloud:
+ enabled: true
+ region: West US 2
+ vm_size: Standard_DS1_v2
+ storage_sku: standard_lrs
+ tag: ci
+
+
Architecture
============