cf-destination-proxy
v1.1.29
Published
Proxy for local development using Cloud Foundry destinations in SAP BTP
Downloads
4
Readme
cf-destination-proxy
Proxy for local development using Cloud Foundry destinations in SAP BTP
Motivation
Local IDEs are still superior in functionality in many ways when compared to online ones.
This tool was built to enable local IDEs (especially VS Code) to access backend destinations defined in a SAP BTP subaccount, making use of the BTP connectivity infrastructure and thus exempting the need of other connection methods (i.e., corporate VPNs) to access backend destinations.
How it works
In principle, this proxy works just like the "On Premise Web Proxy for WebIDE workspace" used by SAP BAS.
Proxying local requests to CF destinations takes 3 steps:
- Your app's application router checks the environment for the
destinations
variable, and forwards the request to the localproxyHost:proxyPort
; - The local proxy server rewrites the request origin and path and then forwards it to the deployed proxy, with appropriate authorization;
- The remote proxy (which is essentially a
@sap/approuter
) extracts the destination name from the rewritten path, fetches the destination from the CF Destination service and finally forwards the original request to the destination.
Usage
Prerequisites
This tool should be deployed in a development space in SAP BTP, so you must have appropriate accesses to the deployment target.
Also, your project must have a local application router.
Deployment
Download the latest MTAR release and deploy it to the development space of your choosing, and take note of the app route.
Using the proxy in your project
1. Install the local proxy:
# globally
npm install --global cf-destination-proxy
# or locally as a dev dependency
npm install --save-dev cf-destination-proxy
2. Then, in your approuter folder, run:
cfdp bind https://your-cf-destination-proxy-deployed-app-route
This will create a .env
file with binding information from the deployed proxy (similar to the SAP BAS "Run configuration" service binding). You can configure some options for this command.
ATTENTION: DO NOT commit any generated *.env
files to your repositories, as they contain credentials to your SAP BTP account.
Always remember this paragraph from the 12 Factor App Config chapter:
A litmus test for whether an app has all config correctly factored out of the code is whether the codebase could be made open source at any moment, without compromising any credentials.
3. Load the .env
file when you run your approuter locally.
For example, in a .vscode/launch.json
file, add this property to your run configuration:
"envFile": "${workspaceFolder}/approuter/.env"
4. To start the local proxy, navigate to the .env
file path and run:
cfdp run
This command also accepts some options.
To automate this in VS Code, create a script in your approuter's package.json
file like this:
"scripts": {
"start": "node node_modules/@sap/approuter/approuter.js",
"proxy": "cfdp run",
Then, create a task in .vscode/launch.json
like so:
"version": "2.0.0",
"tasks": [
{
"type": "npm",
"script": "proxy",
"path": "approuter/",
"isBackground": true,
"problemMatcher": [
{
"owner": "custom",
"pattern": {
"regexp": ".",
},
"background": {
"activeOnStart": true,
"beginsPattern": "^\\[info\\] cf-destination-proxy running on port",
"endsPattern": "^\\[info\\] cf-destination-proxy running on port"
}
}
],
"label": "Run cf-destination-proxy"
},
At last, add the created task as a preLaunchTask
in your run configuration:
"preLaunchTask": "Run cf-destination-proxy",
"outputCapture": "std"
CLI options
-e, --env-path <path>
(default: current directory)
An absolute or relative path for the new file (inbind
) or to read files from (inrun
).-p, --port <port>
(default: 8887)
The port where the local proxy will run. If you want to use this option, you must specify the same value for thebind
andrun
commands.-l, --log
(only forrun
)
Log the proxying of requests (target and destination only).