diff --git a/doc/source/cli/cli_usage_without_auth.rst b/doc/source/cli/cli_usage_targeting_workflows.rst similarity index 59% rename from doc/source/cli/cli_usage_without_auth.rst rename to doc/source/cli/cli_usage_targeting_workflows.rst index b4ef6f85..e1b9b98b 100644 --- a/doc/source/cli/cli_usage_without_auth.rst +++ b/doc/source/cli/cli_usage_targeting_workflows.rst @@ -1,12 +1,10 @@ -Using Mistral without Authentication -==================================== +Using Mistral to execute Workflows on an arbitrary cloud +======================================================== It is possible to execute a workflow on any arbitrary cloud without additional -configuration on the Mistral server side. If authentication is turned off in -the Mistral server (Pecan's `auth_enable = False` option in `mistral.conf`), -there is no need to set the `keystone_authtoken` section. It is possible to -have Mistral use an external OpenStack cloud even when it isn't deployed in -an OpenStack environment (i.e. no Keystone integration). +configuration on the Mistral server side. It is possible to have Mistral use +an external OpenStack cloud even when it isn't deployed in an OpenStack +environment (i.e. no Keystone integration). This setup is particularly useful when Mistral is used in standalone mode, where the Mistral service is not part of the OpenStack cloud and runs @@ -40,3 +38,13 @@ The OS-TARGET-* parameters can be set in environment variables as: $ export OS_TARGET_TENANT_NAME=tenant $ export OS_TARGET_PASSWORD=secret $ export OS_TARGET_REGION_NAME=region + +Note on the --os-target_cacert parameter +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The `--os-target_cacert` parameter can be used to set a CA certificate for +SSL communication with the target cloud's Keystone service. The CA certificate +file is **NOT** transferred to the Mistral server. It is the responsibility of +the user to ensure that the SSL Certificate is accessible for the Mistral +Executor and SSL communication is possible with the target cloud. For testing +purposes it is suggested to use the `--target_insecure` parameter. diff --git a/doc/source/index.rst b/doc/source/index.rst index 1c9383f5..371e06e9 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -13,7 +13,7 @@ Using mistralclient cli/cli_usage_with_openstack cli/cli_usage_with_keycloak - cli/cli_usage_without_auth + cli/cli_usage_targeting_workflows cli/cli_usage_source_execution class_reference