|
| 1 | +# Python Libraries |
| 2 | + |
| 3 | +Endless Lifecycle Support (ELS) for Runtimes & Libraries from TuxCare provides security fixes for a variety of Python Libraries. This allows you to continue running your Python applications without vulnerability concerns, even after official support has ended. |
| 4 | + |
| 5 | +## Supported Python Libraries |
| 6 | + |
| 7 | +* **certifi** |
| 8 | +* **cryptography** |
| 9 | + |
| 10 | + **Supported architecture:** x86_64. |
| 11 | + |
| 12 | +* Other libraries and architectures upon request. |
| 13 | + |
| 14 | +## Connection to ELS for Python Libraries Repository |
| 15 | + |
| 16 | +This guide outlines the steps needed to integrate the TuxCare ELS for Python Libraries repository. |
| 17 | + |
| 18 | +### Step 1: Get user credentials |
| 19 | + |
| 20 | +You need a username and password in order to use TuxCare ELS for Python Libraries repository. Anonymous access is disabled. To receive the credentials please contact [[email protected]](mailto:[email protected]). |
| 21 | + |
| 22 | +### Step 2: Set Up ELS for Python Libraries |
| 23 | + |
| 24 | +To use TuxCare's ELS for Python libraries, follow one of the options below: |
| 25 | + |
| 26 | +#### Option 1: Install a Package with ELS Repository via Command Line |
| 27 | + |
| 28 | +You can install or upgrade a package directly using the ELS repository with your credentials: |
| 29 | + |
| 30 | +<CodeWithCopy> |
| 31 | + |
| 32 | +```text |
| 33 | +pip install --upgrade \ |
| 34 | + -i https://<username>:<password>@nexus.repo.corp.cloudlinux.com/repository/els_python/simple \ |
| 35 | + <package> |
| 36 | +``` |
| 37 | + |
| 38 | +</CodeWithCopy> |
| 39 | + |
| 40 | +**Replace:** |
| 41 | +* `<username>` and `<password>` - with the credentials provided by sales. |
| 42 | +* `<package>` - with the Python package name (e.g., `certifi`). |
| 43 | + |
| 44 | +#### Option 2: Configure `pip` to Use the ELS Repository (Full Replacement) |
| 45 | + |
| 46 | +This method is recommended if you want to use only ELS-patched Python packages from TuxCare and replace the default PyPI source with the TuxCare ELS repository. |
| 47 | + |
| 48 | +1. Create or update the `pip` configuration file and add the following: |
| 49 | + |
| 50 | + <CodeTabs :tabs="[ |
| 51 | + { title: 'Linux/macOS (~/.pip/pip.conf)', content: |
| 52 | + `[global] |
| 53 | + index-url = https://username:[email protected]/repository/els_python/simple` }, |
| 54 | + { title: 'Windows (%APPDATA%\pip\pip.ini)', content: |
| 55 | + `[global] |
| 56 | + index-url = https://username:[email protected]/repository/els_python/simple` } |
| 57 | + ]" /> |
| 58 | + |
| 59 | +2. Run the command to install the latest package version: |
| 60 | + |
| 61 | + <CodeWithCopy> |
| 62 | + |
| 63 | + ```text |
| 64 | + pip install --upgrade <package> |
| 65 | + ``` |
| 66 | + |
| 67 | + </CodeWithCopy> |
| 68 | + |
| 69 | + **Replace `<package>` with the python package name, for example, certifi.** |
| 70 | + |
| 71 | + Or install a specific patched TuxCare version, for example: |
| 72 | + |
| 73 | + <CodeWithCopy> |
| 74 | + |
| 75 | + ```text |
| 76 | + pip install certifi==2021.10.8.post2+tuxcare |
| 77 | + ``` |
| 78 | + |
| 79 | + </CodeWithCopy> |
| 80 | + |
| 81 | +#### Option 3: Add the TuxCare ELS Repository as Additional (recommended ) |
| 82 | + |
| 83 | +If you want to keep using public PyPI and fetch only specific patched packages from TuxCare, use *extra-index-url* instead. In this configuration, make sure to specify the exact patched version (step 2 below), otherwise `pip` may install the version from public PyPI. |
| 84 | + |
| 85 | +1. Create or update the `pip` configuration file and add the following: |
| 86 | + |
| 87 | + <CodeTabs :tabs="[ |
| 88 | + { title: 'Linux/macOS (~/.pip/pip.conf)', content: |
| 89 | + `[global] |
| 90 | + extra-index-url = https://username:[email protected]/repository/els_python/simple` }, |
| 91 | + { title: 'Windows (%APPDATA%\pip\pip.ini)', content: |
| 92 | + `[global] |
| 93 | + extra-index-url = https://username:[email protected]/repository/els_python/simple` } |
| 94 | + ]" /> |
| 95 | + |
| 96 | +2. Run the command to install a specific patched TuxCare version, for example: |
| 97 | + |
| 98 | + <CodeWithCopy> |
| 99 | + |
| 100 | + ```text |
| 101 | + pip install certifi==2021.10.8.post2+tuxcare |
| 102 | + ``` |
| 103 | + |
| 104 | + </CodeWithCopy> |
| 105 | + |
| 106 | + |
0 commit comments