Merge "Update macOS devref info"
This commit is contained in:
commit
fc2897c165
|
@ -18,25 +18,26 @@
|
||||||
Setting Up a Development Environment
|
Setting Up a Development Environment
|
||||||
====================================
|
====================================
|
||||||
|
|
||||||
This page describes how to setup a working Python development
|
This page describes how to setup a working Python development environment that
|
||||||
environment that can be used in developing cinder on Ubuntu, Fedora or
|
can be used in developing cinder on Ubuntu, Fedora or macOS. These instructions
|
||||||
Mac OS X. These instructions assume you're already familiar with
|
assume you're already familiar with git. Refer to GettingTheCode_ for
|
||||||
git. Refer to GettingTheCode_ for additional information.
|
additional information.
|
||||||
|
|
||||||
.. _GettingTheCode: https://wiki.openstack.org/wiki/Getting_The_Code
|
.. _GettingTheCode: https://wiki.openstack.org/wiki/Getting_The_Code
|
||||||
|
|
||||||
Following these instructions will allow you to run the cinder unit tests.
|
Following these instructions will allow you to run the cinder unit tests.
|
||||||
Running cinder is currently only supported on Linux, although you can run the
|
Running cinder is currently only supported on Linux. Some jobs can be run on
|
||||||
unit tests on Mac OS X.
|
macOS, but unfortunately due to some differences in system packages there are
|
||||||
|
known issues with running unit tests.
|
||||||
|
|
||||||
Virtual environments
|
Virtual environments
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
Cinder development uses `virtualenv <https://pypi.org/project/virtualenv>`__ to track and manage Python
|
Cinder development uses `virtualenv <https://pypi.org/project/virtualenv>`__
|
||||||
dependencies while in development and testing. This allows you to
|
to track and manage Python dependencies while in development and testing. This
|
||||||
install all of the Python package dependencies in a virtual
|
allows you to install all of the Python package dependencies in a virtual
|
||||||
environment or "virtualenv" (a special subdirectory of your cinder
|
environment or "virtualenv" (a special subdirectory of your cinder directory),
|
||||||
directory), instead of installing the packages at the system level.
|
instead of installing the packages at the system level.
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
@ -65,25 +66,28 @@ On Ubuntu16.04-64::
|
||||||
|
|
||||||
sudo apt-get install python-dev libssl-dev python-pip git-core libmysqlclient-dev libpq-dev libffi-dev libxslt-dev
|
sudo apt-get install python-dev libssl-dev python-pip git-core libmysqlclient-dev libpq-dev libffi-dev libxslt-dev
|
||||||
|
|
||||||
To get a full python3 development environment, the two python3 packages need to be added to the list above::
|
To get a full python3 development environment, the two python3 packages need to
|
||||||
|
be added to the list above::
|
||||||
|
|
||||||
python3-dev python3-pip
|
python3-dev python3-pip
|
||||||
|
|
||||||
On Fedora-based distributions e.g., Fedora/RHEL/CentOS/Scientific Linux (tested on CentOS 6.5 and CentOS 7.3)::
|
On Red Hat-based distributions e.g., Fedora/RHEL/CentOS/Scientific Linux
|
||||||
|
(tested on CentOS 6.5 and CentOS 7.3)::
|
||||||
|
|
||||||
sudo yum install python-virtualenv openssl-devel python-pip git gcc libffi-devel libxslt-devel mysql-devel postgresql-devel
|
sudo yum install python-virtualenv openssl-devel python-pip git gcc libffi-devel libxslt-devel mysql-devel postgresql-devel
|
||||||
|
|
||||||
On openSUSE-based distributions (SLES 12, openSUSE 13.1, Factory or Tumbleweed)::
|
On openSUSE-based distributions (SLES 12, openSUSE 13.1, Factory or
|
||||||
|
Tumbleweed)::
|
||||||
|
|
||||||
sudo zypper install gcc git libmysqlclient-devel libopenssl-devel postgresql-devel python-devel python-pip
|
sudo zypper install gcc git libmysqlclient-devel libopenssl-devel postgresql-devel python-devel python-pip
|
||||||
|
|
||||||
|
|
||||||
Mac OS X Systems
|
macOS Systems
|
||||||
----------------
|
-------------
|
||||||
|
|
||||||
Install virtualenv::
|
Install virtualenv::
|
||||||
|
|
||||||
sudo easy_install virtualenv
|
sudo pip install virtualenv
|
||||||
|
|
||||||
Check the version of OpenSSL you have installed::
|
Check the version of OpenSSL you have installed::
|
||||||
|
|
||||||
|
@ -94,7 +98,7 @@ MacPorts package for OpenSSL, you will see an error when running
|
||||||
``cinder.tests.auth_unittest.AuthTestCase.test_209_can_generate_x509``.
|
``cinder.tests.auth_unittest.AuthTestCase.test_209_can_generate_x509``.
|
||||||
|
|
||||||
The stock version of OpenSSL that ships with Mac OS X 10.6 (OpenSSL 0.9.8l)
|
The stock version of OpenSSL that ships with Mac OS X 10.6 (OpenSSL 0.9.8l)
|
||||||
or Mac OS X 10.7 (OpenSSL 0.9.8r) works fine with cinder.
|
or later should work fine with cinder.
|
||||||
|
|
||||||
|
|
||||||
Getting the code
|
Getting the code
|
||||||
|
|
Loading…
Reference in New Issue