{"id":18798804,"url":"https://github.com/f5networks/f5-appsvcs-templates","last_synced_at":"2025-04-13T17:22:22.794Z","repository":{"id":41104596,"uuid":"238790273","full_name":"F5Networks/f5-appsvcs-templates","owner":"F5Networks","description":"F5 BIG-IP Application Service Templates (FAST)","archived":false,"fork":false,"pushed_at":"2023-08-10T21:37:03.000Z","size":11476,"stargazers_count":34,"open_issues_count":28,"forks_count":13,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-27T08:11:25.444Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/F5Networks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"contributing/process_release.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORT.MD","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-06T21:40:17.000Z","updated_at":"2024-11-15T04:30:01.000Z","dependencies_parsed_at":"2024-11-07T22:23:07.594Z","dependency_job_id":null,"html_url":"https://github.com/F5Networks/f5-appsvcs-templates","commit_stats":null,"previous_names":[],"tags_count":161,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-appsvcs-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-appsvcs-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-appsvcs-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/F5Networks%2Ff5-appsvcs-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/F5Networks","download_url":"https://codeload.github.com/F5Networks/f5-appsvcs-templates/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248750866,"owners_count":21155797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T22:13:02.339Z","updated_at":"2025-04-13T17:22:22.773Z","avatar_url":"https://github.com/F5Networks.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# F5 BIG-IP Application Services Templates (BIG-IP FAST)\nBIG-IP FAST templates are an easy and effective way to deploy applications on the BIG-IP system using [BIG-IP AS3](https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/).\n\nThe BIG-IP FAST Extension provides a toolset for templating and managing BIG-IP AS3 Applications on BIG-IP.\n\n## Documentation\n\nFor more information about BIG-IP FAST, including installation and usage information, see the [BIG-IP FAST Documentation](https://clouddocs.f5.com/products/extensions/f5-appsvcs-templates/latest/)\n\nClass Function Documentation can be generated locally in either html or markdown, using the following commands to create files in the class's directory:\n```bash\n# default format is html\nnpm run buildjsdoc\n\n# specify html as the format\nnpm run buildjsdoc html\n\n# specifiy markdown as the format\nnpm run buildjsdoc md\n```\n\n\n## Filing Issues and Getting Help\n\nIf you come across a bug or other issue, please use [GitHub Issues](https://github.com/F5networks/f5-appsvcs-templates/issues) to submit an issue for our team.\nYou can also see current known issues on that page.\n\n\n## Installing the RPM\n\n**Prerequisites**\n\n* BIG-IP, TMOS v13.1 or later.\n* BIG-IP AS3 version 3.16 or later must be installed (see the [BIG-IP AS3 Documentation](https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/userguide/installation.html) for details on installing BIG-IP AS3).\n\n### Installing the BIG-IP FAST Extension\n\n1. Download the BIG-IP FAST extension RPM the [GitHub Release](https://github.com/F5networks/f5-appsvcs-templates/releases) Assets.\n\n2. From the BIG-IP system, install the extension by navigating to **iApps \u003e Package Management LX**. Click **Import** and then select the RPM you downloaded.\n\n   * If you are using a BIG-IP version prior to 14.0, before you can use the Configuration utility, you must enable the framework using the BIG-IP command line. From the CLI, type the following command:  ``touch /var/config/rest/iapps/enable``.  You only need to run this command once (per BIG-IP system). This is not necessary with 14.0 and later.\n\n   Once the package is imported, you should see **f5-appsvcs-templates** in the list of installed extensions.\n\n3. Click **iApps \u003e Application Services \u003e Applications LX**.\n\n4. Click **F5 Application Services Templates** to start using BIG-IP FAST.\n\n## Development\n\nVarious script used during development are accessed through `npm`:\n\n* To check for lint errors run `npm run lint`\n* To run unit tests use `npm test`\n\nBoth of these are also run as part of the CI pipeline for this project.\n\n### Building\n\n`rpmbuild` is required to build the RPM.\nAll other dependencies are handled by NPM (make sure to do an `npm install` before trying to build).\n\nTo build everything (recommended), run:\n\n```bash\nnpm run build\n```\n\nTo build just the GUI layer, run:\n\n```bash\nnpm run buildgui\n```\n\nTo build just the RPM package, run:\n\n```bash\nnpm run buildrpm\n```\n\nThe built RPM package and associated sha256 hash will be placed in the `dist` directory.\nThe package can be installed on a BIG-IP using the usual mechanisms for installing iApp LX packages.\nThere is also an `install-rpm` script provided in `scripts` that installs the latest RPM found in `dist` to a target BIG-IP via the REST API.\n\n### Perfomance Tracing\n\nBIG-IP FAST supports perfomance tracing using [Jaeger](https://www.jaegertracing.io/).\n\nTo build RPM package with all required modules for performance tracing, run:\n```bash\nnpm run buildperf\n```\n\nAfter installing RPM package on the BIGIP system, in order to enable performance tracing, the following environment variables are required to be set on the BIGIP system:\n\n * F5_PERF_TRACING_ENABLED - boolean flag to enable BIG-IP FAST Perfomance tracing\n * F5_PERF_TRACING_DEBUG - boolean flag to enable additional logging on Jaeger client\n * F5_PERF_TRACING_ENDPOINT - Jaeger url for sending traces (i.e. http://\u003cip_address\u003e:14268/api/traces)\n\n### Configurable Settings\n\n * FAST Worker: \n   * FAST_INIT_MAX_RETRIES - integer number which represents retries number used for FAST Worker initialization workflow.\n   * FAST_INIT_RETRY_DELAY_IN_MS - milliseconds to delay between retries used within FAST Worker initialization.\n   * FAST_PROVISION_CONFIG_CACHE_TTL_IN_MS - milliseconds to define cache live time for Provision Config.\n   * FAST_JSON_REQ_BODY_LIMIT - string value to control the maximum request body size (i.e. 100kb, 1mb); by default, it uses 1mb\n   \n * AS3 Driver:\n   * FAST_PENDING_TASK_POLL_RATE_IN_MS - milliseconds to define AS3 task poll rate.\n   * FAST_OP_LOCK_TIMEOUT_IN_MS - milliseconds to wait for AS3 request OpLock.\n \n### Logging\n\nAll log messages should contain the worker name (BIG-IP FAST Worker) for easier filtering.\n\nThe following logging levels are used (from low priority to high):\n\n* fine - lower priority informational messages\n* info - higher priority informational messages\n* error - recoverable error (e.g., bad requests)\n* severe - unrecoverable error\n\nA `finest` is also available, but already gets spammed with a lot of socket information, which makes it a common log level to disable.\n\nAll requests and responses are logged at a `fine` log level by default.\nAny response that contains an error status code (\u003e=400) will default to an `error`.\n\n**NOTE:** BIG-IP FAST is the next-generation successor to the now deprecated iApps templates. We strongly recommend **not** using both BIG-IP FAST AND iApp templates together as these templating solutions are incompatible with each other. Using both BIG-IP FAST and iApps is likely to create configuration and source-of-truth conflicts, resulting in an undesirable end-state. \n\n## License\n\n[Apache License 2.0](https://choosealicense.com/licenses/apache-2.0/)\n\n## Copyright\n\nCopyright 2014-2022 F5 Networks Inc.\n\n\n### F5 Networks Contributor License Agreement\n\nBefore you start contributing to any project sponsored by F5 Networks, Inc. (F5) on GitHub, you will need to sign a Contributor License Agreement (CLA).\n\nIf you are signing as an individual, we recommend that you talk to your employer (if applicable) before signing the CLA since some employment agreements may have restrictions on your contributions to other projects.\nOtherwise by submitting a CLA you represent that you are legally entitled to grant the licenses recited therein.\n\nIf your employer has rights to intellectual property that you create, such as your contributions, you represent that you have received permission to make contributions on behalf of that employer, that your employer has waived such rights for your contributions, or that your employer has executed a separate CLA with F5.\n\nIf you are signing on behalf of a company, you represent that you are legally entitled to grant the license recited therein.\nYou represent further that each employee of the entity that submits contributions is authorized to submit such contributions on behalf of the entity pursuant to the CLA.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5networks%2Ff5-appsvcs-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ff5networks%2Ff5-appsvcs-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ff5networks%2Ff5-appsvcs-templates/lists"}