Skip to main content
https://zuul.otc-service.com/api/tenant/eco/badge?project=opentelekomcloud/python-otcextensions&pipeline=check&branch=master Documentation Status

The OTC Extensions augment the OpenStack SDK of features and services provided by the T Cloud Public (former Open Telekom Cloud). If installed as a Python package, they add several extra commands to the OpenStack Client CLI. Therefore the project interacts closely with the

  • python-openstacksdk

  • python-openstackclient

packages.

Documentation

Documentation Overview

Installation

Installation Page

The OTC Extensions are hosted as the package otcextensions on PyPI and can be installed by pip as

There are several options to do that including but not limited to pip userland installation, system wide installation as well as installation from operating system packets or directly from source. Refer to the installation instructions in the projects documentation.

Configuration

Configuration Page

Acessing the T Cloud Public APIs requires authentication and authorization. For both there are several options available:

  • Configuration files (recommended): A file called clouds.yaml holds all necessary configuration parameters. The file can be placed either in the local directory, below the user home directory in .config/openstack or in the system-wide directory /etc/openstack. You may use a second file secure.yaml in the same directories to extra protect clear-text password credentials. For more details see the section configuration in the official documentation.

    Minimal sample clouds.yaml file:

    clouds:
      otc:
        profile: otc
        auth:
          username: '<USER_NAME>'
          password: '<PASSWORD>'
          project_name: '<eu-de_project>'
          # or project_id: '<123456_PROJECT_ID>'
          user_domain_name: 'OTC00000000001000000xxx'
          # or user_domain_id: '<123456_DOMAIN_ID>'
          auth_url: 'https://iam.eu-de.otc.t-systems.com:443/v3'
        interface: 'public'
        identity_api_version: 3 # !Important
        ak: '<AK_VALUE>' # AK/SK pair for access to OBS
        sk: '<SK_VALUE>'

    With this configuration you can start using the CLI with openstack --os-cloud otc *command* or by export OS_CLOUD=otc; openstack *command*.

  • Environment variables: Authentication using username/password is often used:

    export OS_AUTH_URL=<url-to-openstack-identity>
    export OS_IDENTITY_API_VERSION=3
    export OS_PROJECT_NAME=<project-name>
    export OS_PROJECT_DOMAIN_NAME=<project-domain-name>
    export OS_USERNAME=<username>
    export OS_USER_DOMAIN_NAME=<user-domain-name>
    export OS_PASSWORD=<password>  # (optional)
    export S3_ACCESS_KEY_ID=<access_key>
    export S3_SECRET_ACCESS_KEY=<secret_access_key>
  • Command-Line Options: The corresponding command-line options look very similar:

    --os-auth-url <url>
    --os-identity-api-version 3
    --os-project-name <project-name>
    --os-project-domain-name <project-domain-name>
    --os-username <username>
    --os-user-domain-name <user-domain-name>
    [--os-password <password>]
    
    If a password is not provided above (in plaintext), you will be
    interactively prompted to provide one securely.
  • Existing Token: Authentication may also be performed using an already-acquired token and a URL pointing directly to the service API that presumably was acquired from the Service Catalog:

    export OS_TOKEN=<token>
    export OS_URL=<url-to-openstack-service>
  • The corresponding command-line options look very similar:

    --os-token <token>
    --os-url <url-to-openstack-service>

In addition to that a regular clouds.yaml configuration file can be used

More information is available at https://docs.openstack.org/python-openstackclient/latest/cli/authentication.html or https://developer.openstack.org/sdks/python/openstacksdk/users/config

OTC Extensions CLI Usage

OTCE CLI Command Overview

OTC Extensions SDK Guides

OTCE SDK Guides

Contributing

Release files for otcextensions 0.34.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for otcextensions 0.34.7
File Size Uploaded
otcextensions-0.34.7.tar.gz 1.2 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for otcextensions 0.34.7
File Interpreter ABI Platform
otcextensions-0.34.7-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 3.2 MB

Release files / otcextensions-0.34.7.tar.gz

Download URL otcextensions-0.34.7.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
0017e5430facf3b70c4efd9da6579fbbb34b1f8bc0ddabe33f20805f7377328a
BLAKE2b-256 checksum
How to use checksums
83030db10a54323fd43fc97bf47164361232df9693a2374c3f8ac31d6b4f2ed7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.9

Release files / otcextensions-0.34.7-py2.py3-none-any.whl

Download URL otcextensions-0.34.7-py2.py3-none-any.whl
Size 2.0 MB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
6f70231e65c12f97ffa6797128eda83c17078846bbc64e5a3b7e5bc05e456ba9
BLAKE2b-256 checksum
How to use checksums
3adeb326ae397654f75f8d4717f956fe4aa04b032d446307ad192ffcfa8ef928
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.9

Release history Release notifications | RSS feed

This release

0.34.7 This release

2 release files

0.34.5

2 release files

0.34.2

2 release files

0.34.1

2 release files

0.33.0

2 release files

0.32.9

2 release files

0.32.8

2 release files

0.32.7

2 release files

0.32.5

2 release files

0.32.4

2 release files

0.32.3

2 release files

0.32.2

2 release files

0.32.1

2 release files

0.32.0

2 release files

0.31.9

2 release files

0.31.8

2 release files

0.31.7

2 release files

0.31.6

2 release files

0.31.4

2 release files

0.31.3

2 release files

0.31.0

2 release files

0.30.9

2 release files

0.30.8

2 release files

0.30.6

2 release files

0.30.4

2 release files

0.30.3

2 release files

0.30.2

2 release files

0.30.0

2 release files

0.29.2

2 release files

0.29.1

2 release files

0.28.3

2 release files

0.28.2

2 release files

0.28.0

2 release files

0.27.0

2 release files

0.26.3

2 release files

0.26.2

2 release files

0.26.1

2 release files

0.25.0

2 release files

0.24.6

2 release files

0.24.5

2 release files

0.24.4

2 release files

0.24.3

2 release files

0.24.1

2 release files

0.24.0

2 release files

0.23.0

2 release files

0.22.1

2 release files

0.22.0

2 release files

0.21.0

2 release files

0.20.1

2 release files

0.20.0

2 release files

0.18.1

2 release files

0.18.0

2 release files

0.16.1

2 release files

0.16.0

2 release files

0.15.0

2 release files

0.14.0

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.2

2 release files

0.12.0

2 release files

0.11.1

2 release files

0.11.0

2 release files

0.10.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

1 release file

0.6.9

1 release file

0.6.8

1 release file

0.6.7

1 release file

0.6.6

1 release file

0.6.5

1 release file

0.6.4

1 release file

0.6.3

1 release file

0.6.2

1 release file

0.6.1

1 release file

0.6.0

1 release file

0.5.0

1 release file

0.4.0

1 release file

0.3.2

1 release file

0.3.1

1 release file

0.2.0

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page