Merge "Update the documentation link for doc migration"

This commit is contained in:
Zuul 2017-11-14 07:51:12 +00:00 committed by Gerrit Code Review
commit a06ca26ae6
17 changed files with 50 additions and 50 deletions

View File

@ -2,7 +2,7 @@ Barbican Style Commandments
============================ ============================
- Step 1: Read the OpenStack Style Commandments - Step 1: Read the OpenStack Style Commandments
http://docs.openstack.org/developer/hacking/ https://docs.openstack.org/hacking/latest/
- Step 2: Read on - Step 2: Read on

View File

@ -17,7 +17,7 @@ Barbican is an OpenStack project developed by the [Barbican Project Team
Johns Hopkins University, HP, Red Hat, Cisco Systems, and many more. Johns Hopkins University, HP, Red Hat, Cisco Systems, and many more.
The full documentation can be found on the [Barbican Developer Documentation The full documentation can be found on the [Barbican Developer Documentation
Site](http://docs.openstack.org/developer/barbican/). Site](https://docs.openstack.org/barbican/latest/).
If you have a technical question, you can ask it at [Ask OpenStack]( If you have a technical question, you can ask it at [Ask OpenStack](
https://ask.openstack.org/en/questions/) with the `barbican` tag, or you can https://ask.openstack.org/en/questions/) with the `barbican` tag, or you can
@ -48,7 +48,7 @@ ecosystem. The other systems are:
## Getting Started ## Getting Started
Please visit our [Users, Developers and Operators documentation Please visit our [Users, Developers and Operators documentation
](https://docs.openstack.org/developer/barbican/) for details. ](https://docs.openstack.org/barbican/latest/) for details.
## Why Should You Use Barbican? ## Why Should You Use Barbican?

View File

@ -12,7 +12,7 @@ access.
This guide will assume you will be using a local running development environment of barbican. This guide will assume you will be using a local running development environment of barbican.
If you need assistance with getting set up, please reference the If you need assistance with getting set up, please reference the
`development guide <http://docs.openstack.org/developer/barbican/setup/dev.html>`__ `development guide <https://docs.openstack.org/barbican/latest/contributor/dev.html>`__
.. warning:: .. warning::
@ -145,8 +145,8 @@ To set/replace an ACL for a container:
{"acl_ref": "http://localhost:9311/v1/containers/8c077991-d524-4e15-8eaf-bc0c3bb225f2/acl"} {"acl_ref": "http://localhost:9311/v1/containers/8c077991-d524-4e15-8eaf-bc0c3bb225f2/acl"}
To get more details on the create API you can reference the To get more details on the create API you can reference the
`Set Secret ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#put-v1-secrets-uuid-acl>`__ `Set Secret ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#put-v1-secrets-uuid-acl>`__
or `Set Container ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#put-v1-containers-uuid-acl>`__ or `Set Container ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#put-v1-containers-uuid-acl>`__
documentation. documentation.
@ -258,10 +258,10 @@ To update only the users list for secret ACL (use PATCH):
Container and Secret ACL(s) update operation are similar except `containers` resource is used Container and Secret ACL(s) update operation are similar except `containers` resource is used
instead of the `secrets` resource in URI. To get more details on ACL update APIs, you can reference instead of the `secrets` resource in URI. To get more details on ACL update APIs, you can reference
the `Update Secret ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#put-secret-acl>`__ the `Update Secret ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#put-secret-acl>`__
, `Update Container ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#put-container-acl>`__ , `Update Container ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#put-container-acl>`__
, `Partial Update Secret ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#patch-secret-acl>`__ , `Partial Update Secret ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#patch-secret-acl>`__
or `Partial Update Container ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#patch-container-acl>`__ or `Partial Update Container ACL <http://docs.openstack.org/barbican/latest/api/reference/acls.html#patch-container-acl>`__
documentation. documentation.
@ -326,8 +326,8 @@ To get container ACL data:
To get more details on ACL lookup APIs you can reference the To get more details on ACL lookup APIs you can reference the
`Get Secret ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#get-secret-acl>`__ `Get Secret ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#get-secret-acl>`__
, `Get Container ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#get-container-acl>`__ , `Get Container ACL <http://docs.openstack.org/barbican/latest/api/reference/acls.html#get-container-acl>`__
documentation. documentation.
@ -342,7 +342,7 @@ returned on successful deletion.
Delete operation removes existing ACL on a secret or a container if there. It Delete operation removes existing ACL on a secret or a container if there. It
can be treated as resetting a secret or a container to can be treated as resetting a secret or a container to
`Default ACL <http://docs.openstack.org/developer/barbican/api/userguide/acls.html#default-implicit-acl>`__ `Default ACL <https://developer.openstack.org/api-guide/key-manager/acls.html#default-acl>`__
setting. That's why invoking delete multiple times on this resource will not setting. That's why invoking delete multiple times on this resource will not
result in error. result in error.
@ -359,6 +359,6 @@ result in error.
To get more details on ACL delete APIs, you can reference the To get more details on ACL delete APIs, you can reference the
`Delete Secret ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#delete-secret-acl>`__ `Delete Secret ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#delete-v1-secrets-uuid-acl>`__
, `Delete Container ACL <http://docs.openstack.org/developer/barbican/api/reference/acls.html#delete-container-acl>`__ , `Delete Container ACL <https://docs.openstack.org/barbican/latest/api/reference/acls.html#delete-v1-containers-uuid-acl>`__
documentation. documentation.

View File

@ -4,7 +4,7 @@ Consumers API - User Guide
This guide assumes you will be using a local development environment of barbican. This guide assumes you will be using a local development environment of barbican.
If you need assistance with getting set up, please reference the If you need assistance with getting set up, please reference the
`development guide <http://docs.openstack.org/developer/barbican/setup/dev.html>`__. `development guide <https://docs.openstack.org/barbican/latest/contributor/dev.html>`__.
What is a Consumer? What is a Consumer?

View File

@ -16,7 +16,7 @@ held within. These will be broken down in their respective sections.
This guide will assume you will be using a local running development environment of barbican. This guide will assume you will be using a local running development environment of barbican.
If you need assistance with getting set up, please reference the If you need assistance with getting set up, please reference the
`development guide <http://docs.openstack.org/developer/barbican/setup/dev.html>`__. `development guide <https://docs.openstack.org/barbican/latest/contributor/dev.html>`__.
.. _generic_containers: .. _generic_containers:

View File

@ -12,7 +12,7 @@ The orders resource supports the following types:
This user guide provides high level examples of the orders resource. This user guide provides high level examples of the orders resource.
It will assume you will be using a local running development environment of barbican. It will assume you will be using a local running development environment of barbican.
If you need assistance with getting set up, please reference the If you need assistance with getting set up, please reference the
`development guide <http://docs.openstack.org/developer/barbican/setup/dev.html>`__. `development guide <https://docs.openstack.org/barbican/latest/contributor/dev.html>`__.
.. _create_order: .. _create_order:
@ -25,7 +25,7 @@ bit_length, and algorithm must be valid. Otherwise the order will fail and
the secret will not be generated. The example below shows a valid order for the secret will not be generated. The example below shows a valid order for
generating a symmetric key. You can find a more detailed explanation about generating a symmetric key. You can find a more detailed explanation about
the parameters in the the parameters in the
`Orders API <http://docs.openstack.org/developer/barbican/api/reference/orders.html>`__ `Orders API <https://docs.openstack.org/barbican/latest/api/reference/orders.html>`__
documentation. documentation.
.. code-block:: bash .. code-block:: bash
@ -87,7 +87,7 @@ The order metadata is very useful for determining if your order was processed
correctly. Since orders are processed asynchronously, you can use the metadata correctly. Since orders are processed asynchronously, you can use the metadata
returned for the order to verify a successful secret creation. returned for the order to verify a successful secret creation.
The parameters of the response are explained in more detail The parameters of the response are explained in more detail
`here <http://docs.openstack.org/developer/barbican/api/reference/orders.html#get-unique-order-response-attributes>`__. `here <https://docs.openstack.org/barbican/latest/api/reference/orders.html#get-unique-order-response-attributes>`__.
.. _retrieve_order_list: .. _retrieve_order_list:
@ -146,9 +146,9 @@ It is also possible to retrieve all orders for a project.
} }
You can refer to the You can refer to the
`orders parameters <http://docs.openstack.org/developer/barbican/api/reference/orders.html#get-order-parameters>`__ `orders parameters <https://docs.openstack.org/barbican/latest/api/reference/orders.html#get-order-parameters>`__
section of the section of the
`Orders API <http://docs.openstack.org/developer/barbican/api/reference/orders.html>`__ `Orders API <https://docs.openstack.org/barbican/latest/api/reference/orders.html>`__
documentation in order to refine your search among orders. documentation in order to refine your search among orders.
.. _delete_order: .. _delete_order:

View File

@ -17,7 +17,7 @@ configuration for all projects in his cloud.
This guide will assume you will be using a local running development environment of barbican. This guide will assume you will be using a local running development environment of barbican.
If you need assistance with getting set up, please reference the If you need assistance with getting set up, please reference the
`development guide <http://docs.openstack.org/developer/barbican/setup/dev.html>`__. `development guide <https://docs.openstack.org/barbican/latest/contributor/dev.html>`__.
.. _user_project_quotas_overview: .. _user_project_quotas_overview:
@ -102,7 +102,7 @@ with the request.
To get more details on the quota lookup API, you can reference the To get more details on the quota lookup API, you can reference the
`Get Quotas <http://docs.openstack.org/developer/barbican/api/reference/quotas.html#get-quotas-request>`__ `Get Quotas <https://docs.openstack.org/barbican/latest/api/reference/quotas.html#get-quotas-request>`__
documentation. documentation.
@ -134,7 +134,7 @@ To set or replace the quotas for the project with the ID 1234:
To get more details on the project quota setting API you can reference the To get more details on the project quota setting API you can reference the
`Set Project Quotas <http://docs.openstack.org/developer/barbican/api/reference/quotas.html#put-project-quotas>`__ `Set Project Quotas <https://docs.openstack.org/barbican/latest/api/reference/quotas.html#put-project-quotas>`__
documentation. documentation.
@ -206,9 +206,9 @@ The returned response contains a list with all project quota data.
To get more details on project quota lookup APIs you can reference To get more details on project quota lookup APIs you can reference
the the
`Get Project Quota <http://docs.openstack.org/developer/barbican/api/reference/quotas.html#get-project-quotas-uuid>`__ `Get Project Quota <https://docs.openstack.org/barbican/latest/api/reference/quotas.html#get-project-quotas-uuid>`__
and and
`Get Project Quota List <http://docs.openstack.org/developer/barbican/api/reference/quotas.html#get-project-quotas>`__ `Get Project Quota List <https://docs.openstack.org/barbican/latest/api/reference/quotas.html#get-project-quotas>`__
documentation. documentation.
@ -236,5 +236,5 @@ There is no response content returned on successful deletion.
To get more details on project quota delete APIs, you can reference the To get more details on project quota delete APIs, you can reference the
`Delete Project Quotas <http://docs.openstack.org/developer/barbican/api/reference/quotas.html#delete-project-quotas>`__ `Delete Project Quotas <https://docs.openstack.org/barbican/latest/api/reference/quotas.html#delete-project-quotas>`__
documentation. documentation.

View File

@ -14,7 +14,7 @@ To create/update the secret metadata for a specific secret, we will need to know
the secret reference of the secret we wish to add user metadata to. Any metadata the secret reference of the secret we wish to add user metadata to. Any metadata
that was previously set will be deleted and replaced with this metadata. that was previously set will be deleted and replaced with this metadata.
For more information on creating/updating secret metadata, you can view the For more information on creating/updating secret metadata, you can view the
`PUT /v1/secrets/{uuid}/metadata <http://docs.openstack.org/developer/barbican/api/reference/secret_metadata.html#put-secret-metadata>`__ `PUT /v1/secrets/{uuid}/metadata <https://docs.openstack.org/barbican/latest/api/reference/secret_metadata.html#put-secret-metadata>`__
section. section.
.. code-block:: bash .. code-block:: bash

View File

@ -9,7 +9,7 @@ Barbican supports the storage of data for various content-types securely.
This guide will assume you will be using a local running development environment of barbican. This guide will assume you will be using a local running development environment of barbican.
If you need assistance with getting set up, please reference the If you need assistance with getting set up, please reference the
`development guide <http://docs.openstack.org/developer/barbican/setup/dev.html>`__. `development guide <https://docs.openstack.org/barbican/latest/contributor/dev.html>`__.
What is a Secret? What is a Secret?
@ -27,11 +27,11 @@ Some examples of a secret may include:
For the purpose of this user guide, we will use a simple plaintext For the purpose of this user guide, we will use a simple plaintext
secret. If you would like to learn more in detail about secret. If you would like to learn more in detail about
`secret parameters <http://docs.openstack.org/developer/barbican/api/reference/secrets.html#secret-parameters>`__, `secret parameters <https://docs.openstack.org/barbican/latest/api/reference/secrets.html#secret-parameters>`__,
`responses <http://docs.openstack.org/developer/barbican/api/reference/secrets.html#secret_response_attributes>`__, `responses <https://docs.openstack.org/barbican/latest/api/reference/secrets.html#secret_response_attributes>`__,
and `status codes <http://docs.openstack.org/developer/barbican/api/reference/secrets.html#secret_status_codes>`__ and `status codes <https://docs.openstack.org/barbican/latest/api/reference/secrets.html#secret_status_codes>`__
you can reference the you can reference the
`secret reference <http://docs.openstack.org/developer/barbican/api/reference/secrets.html>`__ `secret reference <https://docs.openstack.org/barbican/latest/api/reference/secrets.html>`__
documentation. documentation.
@ -48,7 +48,7 @@ barbican expects the user to provide the payload to be stored within the secret
itself. Once the secret has been created with a payload it cannot be updated. In itself. Once the secret has been created with a payload it cannot be updated. In
this example we will provide a plain text secret. For more information on creating this example we will provide a plain text secret. For more information on creating
secrets you can view the secrets you can view the
`POST /v1/secrets <http://docs.openstack.org/developer/barbican/api/reference/secrets.html#post-secrets>`__ `POST /v1/secrets <https://docs.openstack.org/barbican/latest/api/reference/secrets.html#post-secrets>`__
section. section.
.. code-block:: bash .. code-block:: bash
@ -109,7 +109,7 @@ your own in order to update the secret.
No response will be provided. This is expected behavior! If you do receive a No response will be provided. This is expected behavior! If you do receive a
response, something went wrong and you will have to address that before response, something went wrong and you will have to address that before
moving forward. (For more information visit moving forward. (For more information visit
`PUT /v1/secrets/{uuid} <http://docs.openstack.org/developer/barbican/api/reference/secrets.html#put-secrets>`__ `PUT /v1/secrets/{uuid} <https://docs.openstack.org/barbican/latest/api/reference/secrets.html#put-secrets>`__
.) .)
@ -148,5 +148,5 @@ the initial creation (See :ref:`How to Create a Secret <create_secret>`.)
No response will be provided. This is expected behavior! If you do receive a No response will be provided. This is expected behavior! If you do receive a
response, something went wrong and you will have to address that before response, something went wrong and you will have to address that before
moving forward. (For more information visit moving forward. (For more information visit
`DELETE /v1/secrets/{uuid} <http://docs.openstack.org/developer/barbican/api/reference/secrets.html#delete-secrets>`__ `DELETE /v1/secrets/{uuid} <https://docs.openstack.org/barbican/latest/api/reference/secrets.html#delete-secrets>`__
.) .)

View File

@ -18,4 +18,4 @@ For example
enable_plugin barbican https://git.openstack.org/openstack/barbican stable/liberty enable_plugin barbican https://git.openstack.org/openstack/barbican stable/liberty
For more information, see the "Externally Hosted Plugins" section of For more information, see the "Externally Hosted Plugins" section of
http://docs.openstack.org/developer/devstack/plugins.html https://docs.openstack.org/devstack/latest/plugins.html

View File

@ -80,4 +80,4 @@ Barbican PKCS11/HSM
key labels in /etc/barbican.conf and restart barbican server before key labels in /etc/barbican.conf and restart barbican server before
executing this command. executing this command.
.. _Database Migration: http://docs.openstack.org/developer/barbican/contribute/database_migrations.html .. _Database Migration: https://docs.openstack.org/barbican/latest/contributor/database_migrations.html

View File

@ -18,7 +18,7 @@ Audit middleware creates two events per REST API interaction. First event has
information extracted from request data and the second one has request outcome information extracted from request data and the second one has request outcome
(response). (response).
.. _Audit middleware: https://docs.openstack.org/keystonemiddleware/latest/ .. _Audit middleware: https://docs.openstack.org/keystonemiddleware/latest/audit.html
.. _CADF format: http://www.dmtf.org/sites/default/files/standards/documents/DSP2038_1.0.0.pdf .. _CADF format: http://www.dmtf.org/sites/default/files/standards/documents/DSP2038_1.0.0.pdf
@ -39,8 +39,8 @@ used for creating events in CADF format.
.. _keystonemiddleware: https://github.com/openstack/keystonemiddleware/blob/master/keystonemiddleware/audit.py .. _keystonemiddleware: https://github.com/openstack/keystonemiddleware/blob/master/keystonemiddleware/audit.py
.. _Enabling Middleware Link: https://docs.openstack.org/keystonemiddleware/latest/#enabling-audit-middleware .. _Enabling Middleware Link: https://docs.openstack.org/keystonemiddleware/latest/audit.html#enabling-audit-middleware
.. _Configuring Middleware Link: https://docs.openstack.org/keystonemiddleware/latest/#configure-audit-middleware .. _Configuring Middleware Link: https://docs.openstack.org/keystonemiddleware/latest/audit.html#configure-audit-middleware
.. note:: .. note::

View File

@ -15,8 +15,8 @@ following ways to setup your own.
.. _Simple Dockerized Keystone: https://registry.hub.docker.com/u/ .. _Simple Dockerized Keystone: https://registry.hub.docker.com/u/
jmvrbanac/simple-keystone/ jmvrbanac/simple-keystone/
.. _Installing Keystone: https://docs.openstack.org/developer/keystone/ .. _Installing Keystone: https://docs.openstack.org/keystone/latest/
installing.html install/index.html
Hooking up Barbican to Keystone Hooking up Barbican to Keystone

View File

@ -40,5 +40,5 @@ instead. In case of API, replace ``'X-Auth-Token: $TOKEN'`` with
You can also find detailed explanation to run barbican client with an You can also find detailed explanation to run barbican client with an
unauthenticated context unauthenticated context
`here <https://docs.openstack.org/python-barbicanclient/latest/#unauthenticated-context>`__ and run barbican CLI in no auth mode `here <https://docs.openstack.org/python-barbicanclient/latest/cli/authentication.html#unauthenticated-context>`__ and run barbican CLI in no auth mode
`here <https://docs.openstack.org/python-barbicanclient/latest/#no-auth-mode>`__. `here <https://docs.openstack.org/python-barbicanclient/latest/cli/authentication.html#no-auth-mode>`__.

View File

@ -44,9 +44,9 @@ available plugin.
The API node noted in the previous section is a WSGI server. Similar to The API node noted in the previous section is a WSGI server. Similar to
OpenStack projects such as OpenStack projects such as
`Glance <http://docs.openstack.org/developer/glance>`_ it utilizes paste to `Glance <https://docs.openstack.org/glance/latest/>`_ it utilizes paste to
support configurable middleware such as to interface with support configurable middleware such as to interface with
`Keystone <http://docs.openstack.org/developer/keystone>`_ for authentication `Keystone <https://docs.openstack.org/keystone/latest/>`_ for authentication
and authorization services. `Pecan <http://pecan.readthedocs.org/en/latest>`_ and authorization services. `Pecan <http://pecan.readthedocs.org/en/latest>`_
(a lean Python web framework inspired by CherryPy, TurboGears, and Pylons) is (a lean Python web framework inspired by CherryPy, TurboGears, and Pylons) is
utilized to map resources to REST routes. These resources contain the controller utilized to map resources to REST routes. These resources contain the controller

View File

@ -273,7 +273,7 @@ TODO Items
.. _Alembic Example: https://julo.ch/blog/migrating-content-with-alembic/ .. _Alembic Example: https://julo.ch/blog/migrating-content-with-alembic/
.. _Alembic Operation Reference: https://alembic.readthedocs.org/en/latest/ops.html .. _Alembic Operation Reference: https://alembic.readthedocs.org/en/latest/ops.html
.. _Alembic tutorial: https://alembic.readthedocs.org/en/latest/tutorial.html .. _Alembic tutorial: https://alembic.readthedocs.org/en/latest/tutorial.html
.. _Barbican DevStack: http://docs.openstack.org/developer/barbican/setup/devstack.html .. _Barbican DevStack: https://docs.openstack.org/barbican/latest/contributor/devstack.html
.. _Developer Guide: https://github.com/cloudkeep/barbican/wiki/Developer-Guide .. _Developer Guide: https://github.com/cloudkeep/barbican/wiki/Developer-Guide
.. _Need to alter column types in production database: http://stackoverflow.com/questions/5329255/need-to-alter-column-types-in-production-database-sql-server-2005 .. _Need to alter column types in production database: http://stackoverflow.com/questions/5329255/need-to-alter-column-types-in-production-database-sql-server-2005
.. _OpenStack and SQLAlchemy: https://wiki.openstack.org/wiki/OpenStack_and_SQLAlchemy#Migrations .. _OpenStack and SQLAlchemy: https://wiki.openstack.org/wiki/OpenStack_and_SQLAlchemy#Migrations

View File

@ -6,7 +6,7 @@ description-file =
README.md README.md
author = OpenStack author = OpenStack
author-email = openstack-dev@lists.openstack.org author-email = openstack-dev@lists.openstack.org
home-page = http://docs.openstack.org/developer/barbican/ home-page = https://docs.openstack.org/barbican/latest/
classifier = classifier =
Environment :: OpenStack Environment :: OpenStack
Intended Audience :: Information Technology Intended Audience :: Information Technology