rstgroup / zf-consul-service-discovery-module
Module for Zend Framework that allows to register the application in Consul's Service Discovery.
Requires
- php: ^5.6 || ^7.0
- rstgroup/service-discovery: ^1
- sensiolabs/consul-php-sdk: ^3
- webmozart/assert: ^1
- zendframework/zend-console: ^2.6
- zendframework/zend-modulemanager: ^2
- zendframework/zend-mvc-console: ^1.1
Requires (Dev)
- phpunit/phpunit: ^5.7
Suggests
- rstgroup/zf-local-config-module: To allow saving Consul URL in the configuration during postinstall stage.
This package is not auto-updated.
Last update: 2024-10-27 03:36:58 UTC
README
This module provides logic that allows the application to register itself in Consul's Service Discovery.
Requirements
- PHP: 5.6 or 7.X
- ZF3-compatible application
- reachable Consul Agent API
Installation
Require module with Composer:
composer require rstgroup/zf-consul-service-discovery-module
The next step is adding module to ZF system configuration (config/application.config.php
):
return [ 'modules' => [ (...), 'RstGroup\ZfConsulServiceDiscoveryModule', ], (...) ]
.. and (optionally, but we strongly suggest it) - install rstgroup/zf-local-config-module
.
Configuration
The module requires the presence of:
- Consul API URL
- service name
- service ID (if service name is not unique across the same Consul Agent instance)
Example configuration:
return [ 'rst_group' => [ 'service_discovery' => [ 'service_name' => 'my-service', 'service_id' => 'my-service-1', 'consul' => [ 'url' => 'http://consul-instance.loc:8500', 'check' => [ 'url' => 'http://my-service/check-endpoint', 'name' => 'check-endpoint', 'interval' => '30s', ], 'tags' => [ 'service', 'httpd', 'php' ], ], ], ], ];
Minimal configuration:
return [ 'rst_group' => [ 'service_discovery' => [ 'service_name' => 'my-service', 'consul' => [ 'url' => 'http://consul-instance.loc:8500', ], ], ], ];
We suggest using
rstgroup/zf-external-config-module
to passrst_group.service_discovery.consul.url
key during the provisioning stage - as infrastructure configuration should not be stored in application's repository.
If your service is about to be ran in many instances - then also its name should be passed during the provisioning state.
Usage
Module provides simple commands to register/deregister service in Consul Agent. Both of them are described when you run
php public/index.php
with no arguments.
Registering service in Consul Agent
In POST-install script:
-
(optional) Provide required configuration for Consul Agent:
php public/index.php local-config set rst_group.service_discovery.consul.url http://consul-instance.loc:8500
Let's assume that service name and ID is already in configuration.
Remeber that this command requires you to have
rstgroup/zf-external-config-module
installed as well. -
Register service:
php public/index.php service-discovery consul register
Deregistering service
IN POST-uninstall stage:
```bash
php public/index.php service-discovery consul deregister
```
Running commands with parameters
service-discovery consul register
command has defined set of optional attributes that allows you to override
settings stored in your app's configuration. You can list the full usage information by simply typing:
php public/index.php
Here's the part that describes the zf-consul-service-discovery-module
's commands:
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
RstGroup\ZfConsulServiceDiscoveryMod
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
ZF Service Discovery - Consul
index.php service-discovery consul register [--id=] [--name=] [--tags=] [--check] [--check-url=] [--check-name=] [--check-interval=] Register service in Consul Agent's Service Discovery.
--id= Override ID of service.
--name= Override name of service.
--tags= Override list of tags. Write tags as comma-separated list with no whitespaces.
--check If flag is set, the check is expected to be defined.
--check-url Override service's check URL
--check-name Override service's check name
--check-interval Override service's check interval
index.php service-discovery consul deregister [--id=] Deregister service in Consul Agent' Service Discovery.
--id= Override ID of service.