diff --git a/documentation/modules/ROOT/pages/03-demo.adoc b/documentation/modules/ROOT/pages/03-demo.adoc index 8c07be53..8c7d65f4 100644 --- a/documentation/modules/ROOT/pages/03-demo.adoc +++ b/documentation/modules/ROOT/pages/03-demo.adoc @@ -76,6 +76,141 @@ cd 3scale-OSSM-TravelDemo-Playbooks/ansible ---- * Run the below playbook using the below command and wait until the playbook finishes running + +If the playbook fails, read the message. If it is because of kubernetes module, then install as follows (MACOS install is "python3 -m pip install kubernetes" + +Also, it will likely complain about lxml which means you need to install those modules. the only way I could install lxml on MACOS was to use the latest version of pip and xcode developer tools. + + +For Example: + +TASK [../roles/install : Extract Developer Account ID] ****************************************************************************************************************** +An exception occurred during task execution. To see the full traceback, use -vvv. The error was: ModuleNotFoundError: No module named 'lxml' +fatal: [localhost]: FAILED! => {"changed": false, "msg": "Failed to import the required Python library (lxml) on Johns-MacBook-Pro's Python /usr/local/bin/python3. Please read the module documentation and install it in the appropriate location. If the required library is installed, but Ansible is using the wrong Python interpreter, please consult the documentation on ansible_python_interpreter"} + +NO MORE HOSTS LEFT ****************************************************************************************************************************************************** + +PLAY RECAP ************************************************************************************************************************************************************** +localhost : ok=62 changed=24 unreachable=0 failed=1 skipped=0 rescued=0 ignored=0 + +Johns-MacBook-Pro:ansible jgammon$ python3 -m pip install lxml +Collecting lxml + Downloading lxml-4.9.2.tar.gz (3.7 MB) + ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.7/3.7 MB 6.3 MB/s eta 0:00:00 + Preparing metadata (setup.py) ... done +Installing collected packages: lxml + DEPRECATION: lxml is being installed using the legacy 'setup.py install' method, because it does not have a 'pyproject.toml' and the 'wheel' package is not installed. pip 23.1 will enforce this behaviour change. A possible replacement is to enable the '--use-pep517' option. Discussion can be found at https://github.com/pypa/pip/issues/8559 + Running setup.py install for lxml ... error + error: subprocess-exited-with-error + + × Running setup.py install for lxml did not run successfully. + │ exit code: 1 + ╰─> [121 lines of output] + + + Johns-MacBook-Pro:ansible jgammon$ python -m pip install --upgrade pip +-bash: python: command not found +Johns-MacBook-Pro:ansible jgammon$ python3 -m pip install --upgrade pip +Requirement already satisfied: pip in /Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages (22.3.1) +Collecting pip + Using cached pip-23.0-py3-none-any.whl (2.1 MB) +Installing collected packages: pip + Attempting uninstall: pip + Found existing installation: pip 22.3.1 + Uninstalling pip-22.3.1: + Successfully uninstalled pip-22.3.1 +Successfully installed pip-23.0 + +Johns-MacBook-Pro:ansible jgammon$ pip install pandas +Collecting pandas + Downloading pandas-1.5.3-cp311-cp311-macosx_10_9_x86_64.whl (11.9 MB) + ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 11.9/11.9 MB 6.1 MB/s eta 0:00:00 +Requirement already satisfied: python-dateutil>=2.8.1 in /Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages (from pandas) (2.8.2) +Collecting pytz>=2020.1 + Downloading pytz-2022.7.1-py2.py3-none-any.whl (499 kB) + ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 499.4/499.4 kB 5.7 MB/s eta 0:00:00 +Collecting numpy>=1.21.0 + Downloading numpy-1.24.2-cp311-cp311-macosx_10_9_x86_64.whl (19.8 MB) + ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 19.8/19.8 MB 6.2 MB/s eta 0:00:00 +Requirement already satisfied: six>=1.5 in /Library/Frameworks/Python.framework/Versions/3.11/lib/python3.11/site-packages (from python-dateutil>=2.8.1->pandas) (1.16.0) +Installing collected packages: pytz, numpy, pandas +Successfully installed numpy-1.24.2 pandas-1.5.3 pytz-2022.7.1 +Johns-MacBook-Pro:ansible jgammon$ pip install lxml +Collecting lxml + Using cached lxml-4.9.2.tar.gz (3.7 MB) + Preparing metadata (setup.py) ... done +Installing collected packages: lxml + DEPRECATION: lxml is being installed using the legacy 'setup.py install' method, because it does not have a 'pyproject.toml' and the 'wheel' package is not installed. pip 23.1 will enforce this behaviour change. A possible replacement is to enable the '--use-pep517' option. Discussion can be found at https://github.com/pypa/pip/issues/8559 + Running setup.py install for lxml ... error + error: subprocess-exited-with-error + + × Running setup.py install for lxml did not run successfully. + │ exit code: 1 + ╰─> [121 lines of output] +Johns-MacBook-Pro:ansible jgammon$ pip list +Package Version +------------------ --------- +ansible 7.2.0 +ansible-core 2.14.2 +cachetools 5.3.0 +certifi 2022.12.7 +cffi 1.15.1 +charset-normalizer 3.0.1 +cryptography 39.0.0 +google-auth 2.16.0 +idna 3.4 +Jinja2 3.1.2 +kubernetes 25.3.0 +MarkupSafe 2.1.2 +numpy 1.24.2 +oauthlib 3.2.2 +packaging 23.0 +pandas 1.5.3 +pip 23.0 +pyasn1 0.4.8 +pyasn1-modules 0.2.8 +pycparser 2.21 +python-dateutil 2.8.2 +pytz 2022.7.1 +PyYAML 6.0 +requests 2.28.2 +requests-oauthlib 1.3.1 +resolvelib 0.5.4 +rsa 4.9 +setuptools 65.5.0 +six 1.16.0 +urllib3 1.26.14 +websocket-client 1.5.1 + + +Johns-MacBook-Pro:ansible jgammon$ pip install lxml +Collecting lxml + Using cached lxml-4.9.2.tar.gz (3.7 MB) + Preparing metadata (setup.py) ... done +Installing collected packages: lxml + DEPRECATION: lxml is being installed using the legacy 'setup.py install' method, because it does not have a 'pyproject.toml' and the 'wheel' package is not installed. pip 23.1 will enforce this behaviour change. A possible replacement is to enable the '--use-pep517' option. Discussion can be found at https://github.com/pypa/pip/issues/8559 + Running setup.py install for lxml ... error + error: subprocess-exited-with-error + + × Running setup.py install for lxml did not run successfully. + │ exit code: 1 + ╰─> [121 lines of output] + + Johns-MacBook-Pro:ansible jgammon$ cd /Library/jgammon +-bash: cd: /Library/jgammon: No such file or directory +Johns-MacBook-Pro:ansible jgammon$ xcode-select --install + +Johns-MacBook-Pro:ansible jgammon$ +pip install lxml +Collecting lxml + Using cached lxml-4.9.2.tar.gz (3.7 MB) + Preparing metadata (setup.py) ... done +Installing collected packages: lxml + DEPRECATION: lxml is being installed using the legacy 'setup.py install' method, because it does not have a 'pyproject.toml' and the 'wheel' package is not installed. pip 23.1 will enforce this behaviour change. A possible replacement is to enable the '--use-pep517' option. Discussion can be found at https://github.com/pypa/pip/issues/8559 + Running setup.py install for lxml ... done +Successfully installed lxml-4.9.2 + +=================================================== + [.lines_7] [.console-input]