From 97acc4f216b445185a5202fee84d3add14f7a52e Mon Sep 17 00:00:00 2001 From: Troy McConaghy Date: Fri, 30 Jun 2017 15:00:01 +0200 Subject: [PATCH 1/4] Updated docs re BDB k8s deployment --- .../node-on-kubernetes.rst | 21 +++++++------------ 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/server/source/production-deployment-template/node-on-kubernetes.rst b/docs/server/source/production-deployment-template/node-on-kubernetes.rst index b35c0648..3360271f 100644 --- a/docs/server/source/production-deployment-template/node-on-kubernetes.rst +++ b/docs/server/source/production-deployment-template/node-on-kubernetes.rst @@ -682,7 +682,7 @@ Step 14: Start a Kubernetes Deployment for MongoDB Backup Agent $ kubectl --context k8s-bdb-test-cluster-0 apply -f mongodb-backup-agent/mongo-backup-dep.yaml -Step 15: Start a Kubernetes Deployment for Bigchaindb +Step 15: Start a Kubernetes Deployment for BigchainDB ----------------------------------------------------- * This configuration is located in the file @@ -694,18 +694,13 @@ Step 15: Start a Kubernetes Deployment for Bigchaindb For example, if the value set in the ``bdb-instance-name`` is ``bdb-instance-0``, set the fields to the value ``bdb-insance-0-dep``. - - * Set ``BIGCHAINDB_DATABASE_HOST`` to the value set in ``mdb-instance-name`` - in the ConfigMap. - For example, if the value set in the ``mdb-instance-name`` is - ``mdb-instance-0``, set the field to the value ``mdb-instance-0``. - * Set the appropriate ``BIGCHAINDB_KEYPAIR_PUBLIC``, - ``BIGCHAINDB_KEYPAIR_PRIVATE`` values. - - * One way to generate BigchainDB keypair is to run a Python shell with - the command - ``from bigchaindb_driver import crypto; crypto.generate_keypair()``. + * Set the value of ``BIGCHAINDB_KEYPAIR_PRIVATE`` (not base64-encoded). + (In the future, we'd like to pull the BigchainDB private key from + the Secret named ``bdb-private-key``, + but a Secret can only be mounted as a file, + so BigchainDB Server would have to be modified to look for it + in a file.) * As we gain more experience running BigchainDB in testing and production, we will tweak the ``resources.limits`` values for CPU and memory, and as @@ -719,7 +714,7 @@ Step 15: Start a Kubernetes Deployment for Bigchaindb $ kubectl --context k8s-bdb-test-cluster-0 apply -f bigchaindb/bigchaindb-dep.yaml - * You can check its status using the command ``kubectl get deploy -w`` + * You can check its status using the command ``kubectl get deployments -w`` Step 16: Configure the MongoDB Cloud Manager From ca394bbb93f6b86110d38df46f65764062421f20 Mon Sep 17 00:00:00 2001 From: Troy McConaghy Date: Fri, 30 Jun 2017 15:11:48 +0200 Subject: [PATCH 2/4] Fixed indent of ConfigMap ref to BDB public key --- k8s/bigchaindb/bigchaindb-dep.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/k8s/bigchaindb/bigchaindb-dep.yaml b/k8s/bigchaindb/bigchaindb-dep.yaml index 6a781985..07e795a7 100644 --- a/k8s/bigchaindb/bigchaindb-dep.yaml +++ b/k8s/bigchaindb/bigchaindb-dep.yaml @@ -37,10 +37,10 @@ spec: - name: BIGCHAINDB_WSSERVER_PORT value: "9985" - name: BIGCHAINDB_KEYPAIR_PUBLIC - valueFrom: - configMapKeyRef: - name: bdb-public-key - key: bdb-public-key + valueFrom: + configMapKeyRef: + name: bdb-public-key + key: bdb-public-key - name: BIGCHAINDB_KEYPAIR_PRIVATE value: "" - name: BIGCHAINDB_BACKLOG_REASSIGN_DELAY From 4e45932ac36de2bd45275a11f1325b3e76d63e9e Mon Sep 17 00:00:00 2001 From: Troy McConaghy Date: Fri, 30 Jun 2017 15:54:48 +0200 Subject: [PATCH 3/4] Clarified some MDB Cloud Manager instructions --- .../source/_static/mongodb_cloud_manager_1.png | Bin 0 -> 12196 bytes .../cloud-manager.rst | 12 ++++++++---- 2 files changed, 8 insertions(+), 4 deletions(-) create mode 100644 docs/server/source/_static/mongodb_cloud_manager_1.png diff --git a/docs/server/source/_static/mongodb_cloud_manager_1.png b/docs/server/source/_static/mongodb_cloud_manager_1.png new file mode 100644 index 0000000000000000000000000000000000000000..16073d6b370df4d22a9853a8e266eedf6b509044 GIT binary patch literal 12196 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 Date: Sun, 2 Jul 2017 11:23:40 +0200 Subject: [PATCH 4/4] Formatted & copy-edited steps 16-17.2 --- .../node-on-kubernetes.rst | 118 ++++++++---------- 1 file changed, 53 insertions(+), 65 deletions(-) diff --git a/docs/server/source/production-deployment-template/node-on-kubernetes.rst b/docs/server/source/production-deployment-template/node-on-kubernetes.rst index 3360271f..3ee7d2c5 100644 --- a/docs/server/source/production-deployment-template/node-on-kubernetes.rst +++ b/docs/server/source/production-deployment-template/node-on-kubernetes.rst @@ -720,10 +720,10 @@ Step 15: Start a Kubernetes Deployment for BigchainDB Step 16: Configure the MongoDB Cloud Manager -------------------------------------------- - * Refer to the - :ref:`documentation ` - for details on how to configure the MongoDB Cloud Manager to enable - monitoring and backup. +Refer to the +:ref:`documentation ` +for details on how to configure the MongoDB Cloud Manager to enable +monitoring and backup. Step 17: Verify the BigchainDB Node Setup @@ -732,20 +732,13 @@ Step 17: Verify the BigchainDB Node Setup Step 17.1: Testing Internally ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Run a container that provides utilities like ``nslookup``, ``curl`` and ``dig`` -on the cluster and query the internal DNS and IP endpoints. - -.. code:: bash - - $ kubectl run -it toolbox -- image --restart=Never --rm - -There is a generic image based on alpine:3.5 with the required utilities -hosted at Docker Hub under -`bigchaindb/toolbox `_. -The corresponding +To test the setup of your BigchainDB node, you could use a Docker container +that provides utilities like ``nslookup``, ``curl`` and ``dig``. +For example, you could use a container based on our +`bigchaindb/toolbox `_ image. +(The corresponding `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: .. code:: bash @@ -757,74 +750,69 @@ You can use it as below to get started immediately: --restart=Never --rm 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 -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 +To test the 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 - - $ curl -X GET http://bdb-instance-0:9984 - - * Verify NGINX instance - - .. code:: bash + $ dig +noall +answer _ngx-public-mdb-port._tcp.ngx-instance-0.default.svc.cluster.local SRV - $ nslookup ngx-instance-0 - - $ 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 + $ dig +noall +answer _ngx-public-bdb-port._tcp.ngx-instance-0.default.svc.cluster.local SRV - .. code:: bash + $ curl -X GET http://ngx-instance-0:27017 - $ curl -X GET http://ngx-instance-0:80 - - * If you have the OpenResty NGINX + 3scale instance, run +The curl command should result get the response +``curl: (7) Failed to connect to ngx-instance-0 port 27017: Connection refused``. - .. 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 - portal to verify they are working fine. - - * Send some transactions to BigchainDB and verify it's up and running! +If you ran the OpenResty NGINX + 3scale instance, run: + +.. code:: bash + + $ curl -X GET https://ngx-instance-0 Step 17.2: Testing Externally ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Try to access the ``:80`` -on your browser. You must receive a json output that shows the BigchainDB -server version among other things. +Check the MongoDB monitoring and backup agent on the MongoDB Cloud Manager +portal to verify they are working fine. + +Try to access the ``: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 verify that your node or cluster works as expected. -