Skip to content

Commit

Permalink
Update running-gatewayd.md to handle Docker host connection for diffe…
Browse files Browse the repository at this point in the history
…rent setups (#56)

* Update README to handle Docker host connection for different setups

Signed-off-by: sinadarbouy <[email protected]>

* Update timestamps

---------

Signed-off-by: sinadarbouy <[email protected]>
Co-authored-by: Mostafa Moradian <[email protected]>
  • Loading branch information
sinadarbouy and mostafa authored May 31, 2024
1 parent 45958a6 commit 7f454e0
Show file tree
Hide file tree
Showing 45 changed files with 46 additions and 47 deletions.
2 changes: 1 addition & 1 deletion developing-plugins/grpc-api-reference.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: gRPC API Reference
description: GatewayD exposes a gRPC API that can be used to interact with the GatewayD plugin system. This API can be used by the GatewayD plugins and is available in the GatewayD SDK.
Expand Down
2 changes: 1 addition & 1 deletion developing-plugins/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Developing Plugins
nav_order: 4
Expand Down
2 changes: 1 addition & 1 deletion developing-plugins/plugin-developers-guide.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 21:33:25
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugin Developers Guide
description: Plugin developers' guide of GatewayD
Expand Down
2 changes: 1 addition & 1 deletion developing-plugins/sdk-reference.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: SDK Reference
description: The GatewayD plugin SDK provides a number of interfaces, structs and methods to help you build your plugin.
Expand Down
2 changes: 1 addition & 1 deletion developing-plugins/template-projects.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Template Projects
description: Template projects can be used to quickly get started with developing plugins.
Expand Down
2 changes: 1 addition & 1 deletion getting-started/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Getting Started
nav_order: 1
Expand Down
2 changes: 1 addition & 1 deletion getting-started/installation.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Installation
description: How to install GatewayD and its plugins on different platforms and how to build it from source.
Expand Down
5 changes: 2 additions & 3 deletions getting-started/running-gatewayd.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:18:45
layout: default
title: Running GatewayD
description: How to run GatewayD and test it with psql
Expand Down Expand Up @@ -32,7 +32,7 @@ docker run --rm --name postgres-test -p 5432:5432 -e POSTGRES_PASSWORD=postgres
Test your database by running the following command:

```bash
DOCKER_HOST=$(ip addr show docker0 | grep inet | grep -v inet6 | awk -F' ' '{ print $2 }' | sed 's/\/16//g')
DOCKER_HOST=$(if ip addr show docker0 > /dev/null 2>&1; then ip addr show docker0 | grep inet | grep -v inet6 | awk -F' ' '{ print $2 }' | sed 's/\/.*//'; else echo "host.docker.internal"; fi);
docker exec -it postgres-test psql postgresql://postgres:postgres@${DOCKER_HOST}:5432/postgres -c "\d"
```

Expand Down Expand Up @@ -120,7 +120,6 @@ Running GatewayD will produce the following log output, which means that Gateway
GatewayD is running on the host, while PostgreSQL is running inside a container. You can run the following command to test it. Notice that `${DOCKER_HOST}` holds the IP address of the host machine, that is accessible from inside the container.

```bash
DOCKER_HOST=$(ip addr show docker0 | grep inet | grep -v inet6 | awk -F' ' '{ print $2 }' | sed 's/\/16//g')
docker exec -it postgres-test psql postgresql://postgres:postgres@${DOCKER_HOST}:15432/postgres
```

Expand Down
2 changes: 1 addition & 1 deletion getting-started/welcome.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Welcome
description: Introduction to GatewayD and its key features
Expand Down
2 changes: 1 addition & 1 deletion miscellaneous/glossary.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Glossary
description: Glossary of GatewayD terms
Expand Down
2 changes: 1 addition & 1 deletion miscellaneous/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Miscellaneous
nav_order: 6
Expand Down
2 changes: 1 addition & 1 deletion miscellaneous/telemetry-and-usage-report.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Telemetry and Usage Report
description: Telemetry and usage report of GatewayD
Expand Down
2 changes: 1 addition & 1 deletion plugins/gatewayd-plugin-cache.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: gatewayd-plugin-cache
description: GatewayD plugin for caching query results in Redis.
Expand Down
2 changes: 1 addition & 1 deletion plugins/gatewayd-plugin-js.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: gatewayd-plugin-js
description: GatewayD plugin for running JS functions as hooks.
Expand Down
2 changes: 1 addition & 1 deletion plugins/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugins
nav_order: 5
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/API.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: API
description: GatewayD exposes a gRPC API with an HTTP gateway for querying and managing the `gatewayd` process and its plugins.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/Act.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Act
description: Act is a policy engine that supports signals, policies and actions. It is used to automate the execution of business rules.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/CLI.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: CLI
description: GatewayD is a CLI application that runs on Windows, Linux-based distributions and macOS.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/clients.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Clients
description: Client object is a client that can connect to the database servers over TCP, UDP and Unix Domain Socket.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/configuration.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Configuration
description: GatewayD is fully configurable via various sources, including default values, YAML config files, environment variables, CLI flags and plugins.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/connection-lifecycle.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Connection Lifecycle
description: Connection Lifecycle of GatewayD
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/api.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: API
description: GatewayD gRPC API configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/clients.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Clients
description: GatewayD client configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Global Configuration
nav_order: 2
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/loggers.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Loggers
description: GatewayD logger configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/metrics.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Metrics
description: GatewayD metrics configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/pools.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Pools
description: GatewayD pool configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/proxies.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Proxies
description: GatewayD proxy configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/global-configuration/servers.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Servers
description: GatewayD server configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Using GatewayD
nav_order: 2
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/observability.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Observability
description: Observability is a first-class citizen of GatewayD. It generates logs, metrics and traces to make it easier to see what is going on inside.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: General configurations
description: General configurations for plugins
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/plugins-configuration/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugins Configuration
nav_order: 3
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugins configuration
description: GatewayD plugins configuration
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/pools.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Pools
description: GatewayD has a generic internal pool object that is used to manage plugins and connections.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/protocols.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Protocols
description: GatewayD is application layer protocol-agnostic. This means that GatewayD *can* practically support any protocol in the application layer, or L7.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/proxies.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Proxies
description: Proxy object is used to create a binding between incoming connections from the database clients to the database servers.
Expand Down
2 changes: 1 addition & 1 deletion using-gatewayd/servers.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Servers
description: Server is an object that listens on an address:port pair and accepts connections from database clients.
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/hook-registry.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Hook registry
description: The hook registry is a central place where all hooks are registered and executed. It is used by the plugin registry to register and execute plugin hooks.
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/hooks.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Hooks
description: Plugins can be used to modify the connection lifecycle. Each step in the connection lifecycle is represented by one or more plugin hook(s). Plugins can register themselves to be called when a specific hook is triggered.
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Using Plugins
nav_order: 3
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/plugin-registry.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugin registry
description: The plugin registry is a central place where all plugins are loaded, configured and executed, and also the main entry point for all plugins.
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/plugin-types.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugin types
description: >
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/plugins.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Plugins
description: Plugins play a very important role in GatewayD for adding support for different databases. They are the building blocks of GatewayD, and they are responsible for the majority of the functionality of GatewayD.
Expand Down
2 changes: 1 addition & 1 deletion using-plugins/proposals.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
last_modified_date: 2024-05-11 20:53:27
last_modified_date: 2024-05-31 20:16:38
layout: default
title: Proposals
description: GatewayD proposals are used to propose new ideas and features for GatewayD.
Expand Down

0 comments on commit 7f454e0

Please sign in to comment.