Page History

...

3. Expose Services to the Host

To interact with the API from your host machine, you need to expose the relevant service ports. We'll create a Docker Compose override file that maps the necessary ports.

Steps to expose the API:

1. Create a docker-compose.override.yaml file in the base directory.

2. Add the following configuration to expose the apigw and Jaeger ports:

version: "3"

services:
  apigw:
    ports:
      - "8080:8080"

  jaeger:
    ports:
      - "16686:16686"

This will expose:

The ports for both the API Gateway and Jaeger services are configured in the .env file. The following ports are used by default, but they can be customized by modifying the .env file.

API Gateway:

The APIGW_HOST_PORT is set in the .env file. By default, it is set to 8080.

Access the Swagger documentation:

• http://127.0.0.1:8080/swagger/index.html

Jaeger Tracing:

The JAEGER_HOST_PORT is also set in the .env file, defaulting to 16686.

• http://127.0.0.1:16686
• The apigw service on port 8080.
• The Jaeger tracing UI on port 16686.

...

4. Start the Docker Containers

Start the Docker Containers

The start.sh script will generate a signing key if one doesn’t exist and then With the ports configured, start the Docker containers using the following command:

docker compose up

...

. Run it with:

./start.sh

...

5. Access the Swagger UI for API Exploration

...

This will allow you to monitor the internal communications between the services in real-time.

...

Next Steps

• After exploring the Swagger UI, you can interact with the API directly using

  API

  clients such as curl or Postman. For more information regarding the API, please see this page: Authentic Source using Datastore and Issuer to issue credentials

• Modify the service configurations as needed for your environment or development purposes.

...