The Extended Distributed Calling package allows developers to create and use Distributed Calling providers to cater for different scenarios. Specifically where a hard coded list of server addresses is not possible to obtain for use within Umbraco's Distributed Calling configuration. For example, when hosting an Umbraco application in an Amazon Elastic Load Balanced application. The Extended Distributed Calling package uses a specified provider to obtain a collection of server addresses. Once obtained, a cache refresh request is sent to each server.
If you'd like to contribute to the package, please visit https://github.com/agebase/umbraco-extended-distributed-calling, fork the repository and send a pull request.
The Extended Distributed Calling package can be installed via the package's page on our.umbraco.org or via NuGet. If installing via NuGet, use the following package manager command:
Note: This section only applies if the package is not being installed via NuGet.
Add the following configuration section to
web.config to configure and enable Extended Distributed Calling. As default, we've set-up the below example configuration to use the Amazon Distributed Calling provider:
<configuration> <configSections> <section name="extendedDistributedCalling" type="AgeBase.ExtendedDistributedCalling.Configuration.ExtendedDistributedCallingConfigSection, AgeBase.ExtendedDistributedCalling" /> </configSections> <extendedDistributedCalling enabled="true" user="0" type="AgeBase.ExtendedDistributedCalling.Providers.AmazonDistributedCallingProvider" assembly="AgeBase.ExtendedDistributedCalling" /> </configuration>
enabled attribute can be used to turn Extended Distributed Calling on or off. The
user attribute must contain the user id which will be used to authenticate any cache refresh request. The
type attribute must contain the fully qualified class name. The
assembly attribute must contain the assembly name where the type resides.
To write your own provider, create a new class which implements the
IExtendedDistributedCallingProvider interface. The interface contains one method which requires a list of addresses to be returned. To use your provider, change your
assembly configuration in web.config to the your new provider. To get you started, the Extended Distributed Calling assembly contains the following providers for use within your Umbraco applications:
For use on scalable Amazon Elastic Load Balanced applications. Type and assembly details are as follows:
The provider requires the following Application Settings via web.config. These can either be manually or dynamically added via the AWS console:
AWS_ACCESS_KEY_ID app setting must contain a valid access key to access the AWS API. The
AWS_SECRET_KEY app setting must contain a valid secret key to access the AWS API. The
AWS_ENV_NAME app setting must contain the name of the current ELB's environment. The
AWS_REGION must contain the region of the current ELB's environment. The follow region values are accepted:
Note: For the Amazon Distributed Calling provider to work correctly, each EC2 instance attached to the load balancer must be able to communicate with all other attached EC2 instances. To allow this, the EC2 instance security group must allow incoming HTTP calls from the ELB security group on port 80. Allowing this rule does not open up each EC2 instance to the public.