adding link to python packaging documentation

This commit is contained in:
kevgliss 2015-07-31 19:02:44 -07:00
parent f55a93b29a
commit c5a6a0570a
18 changed files with 53 additions and 40 deletions

View File

@ -223,35 +223,17 @@ If you are not using PING you do not need to configure any of these options
AWS Configuration
=================
AWS Plugin Configuration
========================
In order for Lemur to manage it's own account and other accounts we must ensure it has the correct AWS permissions.
.. note:: AWS usage is completely optional. Lemur can upload, find and manage SSL certificates in AWS. But is not required to do so.
AWS Configuration Options
-------------------------
.. data:: AWS_ACCOUNT_MAPPINGS
:noindex:
Lemur maintains it's own internal table of AWS accounts with their alias and account numbers, this variable is used during setup to bootstrap
your particular enviroment.
Defaults to ``{}``.
::
AWS_ACCOUNT_MAPPINGS = {
'awsaccountalias': 111111111111
}
Setting up IAM roles
--------------------
Lemur uses boto heavily to talk to all the AWS resources it manages. By default it uses the on-instance credentials to make the necessary calls.
Lemur's aws plugin uses boto heavily to talk to all the AWS resources it manages. By default it uses the on-instance credentials to make the necessary calls.
In order to limit the permissions we will create a new two IAM roles for Lemur. You can name them whatever you would like but for example sake we will be calling them LemurInstanceProfile and Lemur.
@ -554,5 +536,3 @@ These permissions are applied to the user upon login and refreshed on every requ
.. seealso::
`Flask-Principal <https://pythonhosted.org/Flask-Principal>`_

View File

@ -5,6 +5,7 @@ auth Package
-------------------------
.. automodule:: lemur.auth.permissions
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ auth Package
---------------------
.. automodule:: lemur.auth.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ auth Package
-------------------
.. automodule:: lemur.auth.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ authorities Package
--------------------
.. automodule:: lemur.authorities.models
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ authorities Package
---------------------
.. automodule:: lemur.authorities.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ authorities Package
-------------------
.. automodule:: lemur.authorities.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ common Package
--------------------
.. automodule:: lemur.common.health
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ common Package
----------------------
.. automodule:: lemur.common.managers
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ common Package
-------------------
.. automodule:: lemur.common.utils
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ destinations Package
--------------------
.. automodule:: lemur.destinations.models
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ destinations Package
---------------------
.. automodule:: lemur.destinations.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ destinations Package
-------------------
.. automodule:: lemur.destinations.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ domains Package
--------------------
.. automodule:: lemur.domains.models
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ domains Package
---------------------
.. automodule:: lemur.domains.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ domains Package
-------------------
.. automodule:: lemur.domains.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ notifications Package
--------------------
.. automodule:: lemur.notifications.models
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ notifications Package
---------------------
.. automodule:: lemur.notifications.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ notifications Package
-------------------
.. automodule:: lemur.notifications.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ base Package
-------------------
.. automodule:: lemur.plugins.base
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ base Package
---------------------
.. automodule:: lemur.plugins.base.manager
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ base Package
----------------
.. automodule:: lemur.plugins.base.v1
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ bases Package
--------------------
.. automodule:: lemur.plugins.bases
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ bases Package
-------------------------
.. automodule:: lemur.plugins.bases.destination
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,6 +23,7 @@ bases Package
--------------------
.. automodule:: lemur.plugins.bases.issuer
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -29,6 +32,7 @@ bases Package
--------------------------
.. automodule:: lemur.plugins.bases.notification
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -37,7 +41,7 @@ bases Package
--------------------
.. automodule:: lemur.plugins.bases.source
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ lemur_aws Package
------------------------
.. automodule:: lemur.plugins.lemur_aws
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ lemur_aws Package
-----------------
.. automodule:: lemur.plugins.lemur_aws.elb
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,6 +23,7 @@ lemur_aws Package
-----------------
.. automodule:: lemur.plugins.lemur_aws.iam
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -29,6 +32,7 @@ lemur_aws Package
--------------------
.. automodule:: lemur.plugins.lemur_aws.plugin
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -37,7 +41,7 @@ lemur_aws Package
-----------------
.. automodule:: lemur.plugins.lemur_aws.sts
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ lemur_cloudca Package
----------------------------
.. automodule:: lemur.plugins.lemur_cloudca
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,7 +14,7 @@ lemur_cloudca Package
--------------------
.. automodule:: lemur.plugins.lemur_cloudca.plugin
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ lemur_email Package
--------------------------
.. automodule:: lemur.plugins.lemur_email
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ lemur_email Package
--------------------
.. automodule:: lemur.plugins.lemur_email.plugin
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -23,4 +25,3 @@ Subpackages
.. toctree::
lemur.plugins.lemur_email.templates

View File

@ -5,6 +5,7 @@ lemur_verisign Package
-----------------------------
.. automodule:: lemur.plugins.lemur_verisign
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ lemur_verisign Package
-----------------------
.. automodule:: lemur.plugins.lemur_verisign.constants
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ lemur_verisign Package
--------------------
.. automodule:: lemur.plugins.lemur_verisign.plugin
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ roles Package
--------------------
.. automodule:: lemur.roles.models
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ roles Package
---------------------
.. automodule:: lemur.roles.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,6 +23,7 @@ roles Package
-------------------
.. automodule:: lemur.roles.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,7 +5,7 @@ status Package
-------------------
.. automodule:: lemur.status.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -5,6 +5,7 @@ users Package
--------------------
.. automodule:: lemur.users.models
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -13,6 +14,7 @@ users Package
---------------------
.. automodule:: lemur.users.service
:noindex:
:members:
:undoc-members:
:show-inheritance:
@ -21,7 +23,7 @@ users Package
-------------------
.. automodule:: lemur.users.views
:noindex:
:members:
:undoc-members:
:show-inheritance:

View File

@ -75,6 +75,8 @@ at multiple plugins within your package::
That's it! Users will be able to install your plugin via ``pip install <package name>``.
.. SeeAlso:: For more information about python packages see `Python Packaging <https://packaging.python.org/en/latest/distributing.html>`_
.. _PluginInterfaces:
Plugin Interfaces
@ -112,7 +114,7 @@ If you wish to be able to create new authorities implement the following functio
.. Note::
Lemur uses PEM (PKCS#7) certificates as it's internal standard, if you recieve certificates in other formats convert them to PEM before returning.
Lemur uses PEM formatted certificates as it's internal standard, if you receive certificates in other formats convert them to PEM before returning.
If instead you do not need need to generate authorities but instead use a static authority (Verisign, DigiCert), you can use publicly available constants::