xyzzy-grpc

Development

Testing

Testable stack

1. Build Senzing installer. This is used to install the Senzing binaries. Example:

   curl -X GET \
       --output /tmp/senzing-versions-latest.sh \
       https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/senzing-versions-latest.sh
   source /tmp/senzing-versions-latest.sh
   
   sudo docker build \
       --build-arg SENZING_ACCEPT_EULA=I_ACCEPT_THE_SENZING_EULA \
       --build-arg SENZING_APT_INSTALL_PACKAGE=senzingapi=${SENZING_VERSION_SENZINGAPI_BUILD} \
       --build-arg SENZING_DATA_VERSION=${SENZING_VERSION_SENZINGDATA} \
       --tag senzing/installer:${SENZING_VERSION_SENZINGAPI} \
       https://github.com/senzing/docker-installer.git#main
   

2. Install Senzing. This installs Senzing into the "system" locations (e.g. /opt/senzing). Example:

    curl -X GET \
        --output /tmp/senzing-versions-latest.sh \
        https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/senzing-versions-latest.sh
    source /tmp/senzing-versions-latest.sh
    sudo rm -rf /opt/senzing
    sudo mkdir -p /opt/senzing
    sudo docker run \
        --rm \
        --user 0 \
        --volume /opt/senzing:/opt/senzing \
        senzing/installer:${SENZING_VERSION_SENZINGAPI}
   

3. Bring up Senzing stack: Example:

   export DOCKER_COMPOSE_DIR=~/my-senzing-grpc-stack
   export DOCKER_COMPOSE_YAML=postgresql/docker-compose-rabbitmq-postgresql.yaml
   
   rm -rf ${DOCKER_COMPOSE_DIR:-/tmp/nowhere/for/safety}
   mkdir -p ${DOCKER_COMPOSE_DIR}
   
   curl -X GET \
       --output ${DOCKER_COMPOSE_DIR}/docker-compose.yaml \
       "https://raw.githubusercontent.com/Senzing/docker-compose-demo/main/resources/${DOCKER_COMPOSE_YAML}"
   
   curl -X GET \
       --output /tmp/docker-versions-latest.sh \
       https://raw.githubusercontent.com/Senzing/knowledge-base/main/lists/docker-versions-latest.sh
   source /tmp/docker-versions-latest.sh
   
   export SENZING_DATA_VERSION_DIR=/opt/senzing/data
   export SENZING_ETC_DIR=/etc/opt/senzing
   export SENZING_G2_DIR=/opt/senzing/g2
   export SENZING_VAR_DIR=/var/opt/senzing
   
   export PGADMIN_DIR=${DOCKER_COMPOSE_DIR}/pgadmin
   export POSTGRES_DIR=${DOCKER_COMPOSE_DIR}/postgres
   export RABBITMQ_DIR=${DOCKER_COMPOSE_DIR}/rabbitmq
   
   sudo mkdir -p ${PGADMIN_DIR} ${POSTGRES_DIR} ${RABBITMQ_DIR}
   sudo chown $(id -u):$(id -g) -R ${DOCKER_COMPOSE_DIR}
   sudo chmod -R 770 ${DOCKER_COMPOSE_DIR}
   sudo chmod -R 777 ${PGADMIN_DIR}
   
   cd ${DOCKER_COMPOSE_DIR}
   sudo --preserve-env docker-compose up
   

Test gRPC server

1. Identify git repository.

   export GIT_ACCOUNT=docktermj
   export GIT_REPOSITORY=go-xyzzy-grpc
   export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
   export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
   

2. Using the environment variables values just set, follow steps in clone-repository to install the Git repository.

3. :pencil2: Set environment variables. Identify Database URL of database in docker-compose stack. Example:

   export LOCAL_IP_ADDRESS=$(curl --silent https://raw.githubusercontent.com/Senzing/knowledge-base/main/gists/find-local-ip-address/find-local-ip-address.py | python3 -)
   export SENZING_TOOLS_DATABASE_URL=postgresql://postgres:postgres@${LOCAL_IP_ADDRESS}:5432/G2
   

4. Run gRPC server unit server tests.

   cd ${GIT_REPOSITORY_DIR}
   make \
     --environment-overrides \
     test-g2diagnostic-server
   

5. Run gRPC server.

   cd ${GIT_REPOSITORY_DIR}
   make \
     --environment-overrides \
     run-g2diagnostic-server
   

Test gRPC client

1. Identify git repository.

   export GIT_ACCOUNT=docktermj
   export GIT_REPOSITORY=go-xyzzy-grpc
   export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
   export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
   

2. :pencil2: Set environment variables. Identify Database URL of database in docker-compose stack. Example:

   export LOCAL_IP_ADDRESS=$(curl --silent https://raw.githubusercontent.com/Senzing/knowledge-base/main/gists/find-local-ip-address/find-local-ip-address.py | python3 -)
   export SENZING_TOOLS_DATABASE_URL=postgresql://postgres:postgres@${LOCAL_IP_ADDRESS}:5432/G2
   

3. Run gRPC client unit tests.

   cd ${GIT_REPOSITORY_DIR}
   make \
     --environment-overrides \
     test-g2diagnostic-client
   

4. Run gRPC client.

   cd ${GIT_REPOSITORY_DIR}
   make \
     --environment-overrides \
     run-g2diagnostic-client