Cloud Docs Home > F5 Application Services Proxy Index

Configure the ASP with the ASP Controller for Marathon

The ASP Controller for Marathon dynamically deploys the Application Services Proxy (ASP) in Apache Mesos Marathon when it discovers a Marathon Application that has the f5-asp:enable label.

When you launch the ASP Controller for Marathon, provide the configuration parameter(s) you want the ASP Controller to apply to the ASP. Define these configuration parameters in the "env" section of the ASP Controller Application definition.

Required configuration parameters

Parameter Description
MARATHON_URL Marathon service URL (e.g., http://10.190.25.75:8080)
ASP_DEFAULT_URIS Marathon Docker Store credentials URI (required to pull ASP image) [1]
[1]See Set up Marathon to use a private Docker registry.

Default configurations

The ASP Controller for Marathon applies the following configurations to the Application Services Proxy by default. You can override any default settings using the marathon-asp-ctlr override labels.

Parameter Value
ASP_ENABLE_LABEL “f5-asp”
ASP_DEFAULT_CPU 1.0
ASP_DEFAULT_MEM 256.0
ASP_DEFAULT_COUNT_PER_APP 1
ASP_DEFAULT_CONTAINER store/f5networks/asp:1.0.0
ASP_DEFAULT_CONTAINER_PORT 8000
Listing 11 Example Application definition
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
//NOTE: REMOVE ALL COMMENTS BEFORE USING THIS FILE
{
  "id": "/marathon-asp-ctlr",
  "cpus": 1,
  "mem": 128,
  "instances": 1,
  "container": {
    "type": "DOCKER",
    "docker": {
      "image": "f5networks/marathon-asp-ctlr:1.1.0",
      "network": "BRIDGE",
      "forcePullImage": true,
      "privileged": false,
      "portMappings": []
    },
    "volumes": []
  },
  // defines the global ASP configurations
  "env": {
    "MARATHON_URL": "http://10.190.25.75:8080",
    // ASP image
    "ASP_DEFAULT_CONTAINER": "store/f5networks/asp:1.1.0",
    // defines the label you will use in App definitions to activate the ASP
    "ASP_ENABLE_LABEL": "f5-asp",
    // provide the location where credentials for Docker Store can be found
    // REQUIRED TO PULL THE ASP IMAGE
    "ASP_DEFAULT_URIS": "file:///etc/docker.tar.gz",
    "ASP_DEFAULT_CPU": "1",
    "ASP_DEFAULT_MEM": "256",
    "ASP_DEFAULT_LOG_LEVEL": "debug",
    // Required as of ASP v1.1
    // Replace "myUser" with the name of an ephemeral-store user;
    // must match the "/CN" setting provided for a user certificate
    // Provide the complete contents of the user .key and .crt files
    // Provide the complete contents of the rootCA.crt file
    "ASP_EPHEMERAL_STORE": "{
      \"host\": \"ephemeral-store.marathon.l4lb.thisdcos.directory\",
      \"port\": 8087,
      \"users\": {
         \"myUser\" : {
             \"key\": \"<user-private-key-in-PEM-format>\",
             \"cert\": \"<user-cert-in-PEM-format>\"
         }
      },
      \"root-ca\": \"<rootCA-cert-in-PEM-format>\"
    }",
    "ASP_DEFAULT_STATS_FLUSH_INTERVAL": "10000",
    // include if sending stats to an external service
    "ASP_DEFAULT_STATS_URL": "http://<splunk_url>:8088",
    "ASP_DEFAULT_STATS_TOKEN": "<provide_stats_auth_token>",
    "ASP_DEFAULT_STATS_BACKEND": "splunk"
  }
}

See Also

See the F5 Marathon ASP Controller documentation for the full list of available configuration parameters.