Mirroristas/bigchaindb
2
0
Fork 0
mirror of https://github.com/bigchaindb/bigchaindb.git synced 2024-10-13 13:34:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Formatted & copy-edited steps 16-17.2

Browse Source
This commit is contained in:
Troy McConaghy 2017-07-02 11:23:40 +02:00
parent 4e45932ac3
commit 07b5e0e5da
1 changed files with 53 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

118
docs/server/source/production-deployment-template/node-on-kubernetes.rst
View File

@ -720,10 +720,10 @@ Step 15: Start a Kubernetes Deployment for BigchainDB
Step 16: Configure the MongoDB Cloud Manager Step 16: Configure the MongoDB Cloud Manager
-------------------------------------------- --------------------------------------------
* Refer to the Refer to the
:ref:`documentation <Configure MongoDB Cloud Manager for Monitoring and Backup>` :ref:`documentation <Configure MongoDB Cloud Manager for Monitoring and Backup>`
for details on how to configure the MongoDB Cloud Manager to enable for details on how to configure the MongoDB Cloud Manager to enable
monitoring and backup. monitoring and backup.
Step 17: Verify the BigchainDB Node Setup Step 17: Verify the BigchainDB Node Setup
@ -732,20 +732,13 @@ Step 17: Verify the BigchainDB Node Setup
Step 17.1: Testing Internally Step 17.1: Testing Internally
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Run a container that provides utilities like ``nslookup``, ``curl`` and ``dig`` To test the setup of your BigchainDB node, you could use a Docker container
on the cluster and query the internal DNS and IP endpoints. that provides utilities like ``nslookup``, ``curl`` and ``dig``.
For example, you could use a container based on our
.. code:: bash `bigchaindb/toolbox <https://hub.docker.com/r/bigchaindb/toolbox/>`_ image.
(The corresponding
$ kubectl run -it toolbox -- image <docker image to run> --restart=Never --rm
There is a generic image based on alpine:3.5 with the required utilities
hosted at Docker Hub under
`bigchaindb/toolbox <https://hub.docker.com/r/bigchaindb/toolbox/>`_.
The corresponding
`Dockerfile <https://github.com/bigchaindb/bigchaindb/blob/master/k8s/toolbox/Dockerfile>`_ `Dockerfile <https://github.com/bigchaindb/bigchaindb/blob/master/k8s/toolbox/Dockerfile>`_
is in the ``bigchaindb/bigchaindb`` repository on GitHub. is in the ``bigchaindb/bigchaindb`` repository on GitHub.)
You can use it as below to get started immediately: You can use it as below to get started immediately:
.. code:: bash .. code:: bash
@ -757,74 +750,69 @@ You can use it as below to get started immediately:
--restart=Never --rm --restart=Never --rm
It will drop you to the shell prompt. It will drop you to the shell prompt.
Now you can query for the ``mdb`` and ``bdb`` service details.
The ``nslookup`` commands should output the configured IP addresses of the To test the MongoDB instance:
services in the cluster
The ``dig`` commands should return the port numbers configured for the
various services in the cluster.
Finally, the ``curl`` commands test the availability of the services
themselves.
* Verify MongoDB instance
.. code:: bash .. code:: bash
$ nslookup mdb-instance-0 $ nslookup mdb-instance-0
$ dig +noall +answer _mdb-port._tcp.mdb-instance-0.default.svc.cluster.local SRV $ dig +noall +answer _mdb-port._tcp.mdb-instance-0.default.svc.cluster.local SRV
$ curl -X GET http://mdb-instance-0:27017 $ curl -X GET http://mdb-instance-0:27017
The ``nslookup`` command should output the configured IP address of the service
(in the cluster).
The ``dig`` command should return the configured port numbers.
The ``curl`` command tests the availability of the service.
To test the BigchainDB instance:
* Verify BigchainDB instance .. code:: bash
$ nslookup bdb-instance-0
$ dig +noall +answer _bdb-port._tcp.bdb-instance-0.default.svc.cluster.local SRV
$ curl -X GET http://bdb-instance-0:9984
To test the NGINX instance:
.. code:: bash .. code:: bash
$ nslookup bdb-instance-0 $ nslookup ngx-instance-0
$ dig +noall +answer _bdb-port._tcp.bdb-instance-0.default.svc.cluster.local SRV $ dig +noall +answer _ngx-public-mdb-port._tcp.ngx-instance-0.default.svc.cluster.local SRV
$ curl -X GET http://bdb-instance-0:9984
* Verify NGINX instance
.. code:: bash
$ nslookup ngx-instance-0 $ dig +noall +answer _ngx-public-bdb-port._tcp.ngx-instance-0.default.svc.cluster.local SRV
$ dig +noall +answer _ngx-public-mdb-port._tcp.ngx-instance-0.default.svc.cluster.local SRV
$ curl -X GET http://ngx-instance-0:27017 # results in curl: (56) Recv failure: Connection reset by peer
$ dig +noall +answer _ngx-public-bdb-port._tcp.ngx-instance-0.default.svc.cluster.local SRV
* If you have run the vanilla NGINX instance, run
.. code:: bash $ curl -X GET http://ngx-instance-0:27017
$ curl -X GET http://ngx-instance-0:80 The curl command should result get the response
``curl: (7) Failed to connect to ngx-instance-0 port 27017: Connection refused``.
* If you have the OpenResty NGINX + 3scale instance, run
.. code:: bash If you ran the vanilla NGINX instance, run:
$ curl -X GET https://ngx-instance-0 .. code:: bash
$ curl -X GET http://ngx-instance-0:80
* Check the MongoDB monitoring and backup agent on the MongoDB Cloud Manager If you ran the OpenResty NGINX + 3scale instance, run:
portal to verify they are working fine.
.. code:: bash
* Send some transactions to BigchainDB and verify it's up and running!
$ curl -X GET https://ngx-instance-0
Step 17.2: Testing Externally Step 17.2: Testing Externally
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Try to access the ``<dns/ip of your exposed bigchaindb service endpoint>:80`` Check the MongoDB monitoring and backup agent on the MongoDB Cloud Manager
on your browser. You must receive a json output that shows the BigchainDB portal to verify they are working fine.
server version among other things.
Try to access the ``<DNS/IP of your exposed BigchainDB service endpoint>:80``
on your browser. You should receive a JSON response that shows the BigchainDB
server version, among other things.
Use the Python Driver to send some transactions to the BigchainDB node and Use the Python Driver to send some transactions to the BigchainDB node and
verify that your node or cluster works as expected. verify that your node or cluster works as expected.