{"type":"doc","content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"SINCE VERSION 1.0","localId":"cfca5246-ce07-4362-8132-ca78a439c37f"}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"26bfcc51-5ba3-4e76-b844-d4c3abbc0ef7"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"344faf3c-5813-4dca-83af-6df36059231f"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"What is the Command Line Interface (CLI)?","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Command Line Interface","type":"text","marks":[{"type":"strong"}]},{"text":" (short “","type":"text"},{"text":"CLI","type":"text","marks":[{"type":"strong"}]},{"text":"” or “","type":"text"},{"text":"pi tool","type":"text","marks":[{"type":"strong"}]},{"text":"”) is a local command-line tool, which allows remote control and development of PIPEFORCE from your local terminal.","type":"text"}]},{"type":"paragraph","content":[{"text":"It makes it handy to do for example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Manage the PIPEFORCE Cloud remotely","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect On Premises systems with PIPEFORCE Cloud","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Easily execute single cloud commands or pipelines on the terminal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Develop integrations, apps, workflows and reports from within your preferred IDE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run and monitor tests","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Automate and execute business workflows","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The tutorial ","type":"text"},{"text":"Setup local workspace + CLI","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/tutorials/localworkspace"}}]},{"text":" shows, how to install and work with the CLI.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Download & Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"See the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://logabit.atlassian.net/wiki/spaces/PA/pages/2548400545"}},{"text":" section on how to install this tool.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Usage","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#usage"}}]}]},{"type":"paragraph","content":[{"text":"The main structure of a CLI command is always like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi ","type":"text"}]},{"type":"paragraph","content":[{"text":"To get a list of ","type":"text"},{"text":"all","type":"text","marks":[{"type":"strong"}]},{"text":" supported actions and their parameters, use the help command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi help","type":"text"}]},{"type":"paragraph","content":[{"text":"Below, you can find the description of the ","type":"text"},{"text":"most important","type":"text","marks":[{"type":"strong"}]},{"text":" actions and their usage. For a full list and detailed explaination of its options, use ","type":"text"},{"text":"pi help","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi command","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-command"}}]}]},{"type":"paragraph","content":[{"text":"This executes a single pipeline command at the server-side and returns the result.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each parameter will become a command-line parameter.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi command log message=HELLO","type":"text"}]},{"type":"paragraph","content":[{"text":"This executes the ","type":"text"},{"text":"log","type":"text","marks":[{"type":"code"}]},{"text":" command at server-side with the parameter ","type":"text"},{"text":"message","type":"text","marks":[{"type":"code"}]},{"text":" set to ","type":"text"},{"text":"HELLO","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi command mail.send to=my@email.tld subject=Hello message=\"This is a test\"","type":"text"}]},{"type":"paragraph","content":[{"text":"This command sends an email.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Use the command ","type":"text"},{"text":"pi help command","type":"text","marks":[{"type":"code"}]},{"text":" to get the documentation of all available commands activated in your license.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Or use the command ","type":"text"},{"text":"pi help command COMMAND_NAME","type":"text","marks":[{"type":"code"}]},{"text":" to get the documentation for a specific command.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi delete","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-delete"}}]}]},{"type":"paragraph","content":[{"text":"This deletes the remote resources inside a given app. It doesn’t delete any local resource.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi delete global/app/myapp/pipeline/helloworld","type":"text"}]},{"type":"paragraph","content":[{"text":"This deletes the pipeline helloworld.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi delete global/app/myapp/**","type":"text"}]},{"type":"paragraph","content":[{"text":"This deletes all resources of the app ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This command deletes remote resources without the option to recover. So, be careful in using it!","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi get","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"91af51fb-4442-499d-a5b1-5abf0e3ddd41"}},{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-get"}}]}]},{"type":"paragraph","content":[{"text":"This downloads all resources of a given app, stores them into the local workspace in order to be able to edit them. If a local resource already exists, this asks for either to overwrite or to skip.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi get global/app/myapp/**","type":"text"}]},{"type":"paragraph","content":[{"text":"This command-line call downloads all resources of the app ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":" and its sub-folders, and stores them into the local workspace folder ","type":"text"},{"text":"properties/global/app/myapp","type":"text","marks":[{"type":"code"}]},{"text":". Note, that you have to define the property key here, not the local file path.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This downloads only the resources inside the ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":" folder, but no resource from inside its sub-folders.","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi get global/app/myapp/*","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 3:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This downloads a single resource by its key:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi get global/app/myapp/pipeline/hello","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi init","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-init"}}]}]},{"type":"paragraph","content":[{"text":"This command initializes a given folder as a PIPEFORCE workspace folder. It creates all necessary folder structure and configuration files in order to start development of new PIPEFORCE apps inside it. Such a workspace folder can contain one or more apps to be published to PIPEFORCE. It's also good practise to commit the whole workspace folder as single repo to GitHub (or your preferred source code management system).","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi init","type":"text"}]},{"type":"paragraph","content":[{"text":"This will create a file and folder structure like this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":".pipeforce","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"config.json","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"global","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"app","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PIPEFORCE.code-workspace","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The file ","type":"text"},{"text":"config.json","type":"text","marks":[{"type":"code"}]},{"text":" will contain all required settings for this workspace. Feel free adjust to your needs.","type":"text"}]},{"type":"paragraph","content":[{"text":"The folder ","type":"text"},{"text":"properties","type":"text","marks":[{"type":"code"}]},{"text":" is the default home folder for all properties which will be deployed to PIPEFORCE using the command ","type":"text"},{"text":"pi publish","type":"text","marks":[{"type":"code"}]},{"text":". The structure inside this folder must correspond with the structure in the property store, you would like to deploy.","type":"text"}]},{"type":"paragraph","content":[{"text":"The file ","type":"text"},{"text":"PIPEFORCE.code-workspace","type":"text","marks":[{"type":"code"}]},{"text":" is the default workspace configuration for Visual Studio Code. Feel free to delete it in case you're using a different development environment.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi help","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-help"}}]}]},{"type":"paragraph","content":[{"text":"This lists all available CLI options or pipeline commands.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi help","type":"text"}]},{"type":"paragraph","content":[{"text":"This lists all available command-line options.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi help command","type":"text"}]},{"type":"paragraph","content":[{"text":"This lists the documentation of all available pipeline commands for the currently logged-in user.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi help command log","type":"text"}]},{"type":"paragraph","content":[{"text":"This explains the log pipeline command. The output could look like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"log:\n type: \"object\"\n description: \"Logs the given input message without changing it. Sets the log message\\\n \\ in the body in case body is empty. Doesn't overwrite any existing content in\\\n \\ the body.\"\n inputType: \"JsonNode\"\n outputType: \"JsonNode\"\n properties:\n message:\n type: \"number\"\n description: \"The message to log. Can be a string or a pipe expression. If null\\\n \\ or empty, the full pipe message will be logged.\"\n default: null\n level:\n type: \"string\"\n description: \"The log level. Can be one of DEBUG, TRACE, INFO, WARN, ERROR.\\\n \\ If null or empty, INFO will be used.\"\n default: \"INFO\"\n required:\n - \"message\"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi list","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-list"}}]}]},{"type":"paragraph","content":[{"text":"This lists all remote resources of a given path.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi list global/app/myapp**","type":"text"}]},{"type":"paragraph","content":[{"text":"This lists all resources of the app ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":" recursively.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi list global/app/myapp/*","type":"text"}]},{"type":"paragraph","content":[{"text":"This lists all resources of the folder ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":", but not the resources inside any sub-folder.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi new","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-new"}}]}]},{"type":"paragraph","content":[{"text":"This creates a new resource based on a wizard.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi new","type":"text"}]},{"type":"paragraph","content":[{"text":"This would print this wizard:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Create new...\n 0: app\n 1: form\n 2: list\n 3: object\n 4: pipeline\n 5: workflow\nChoose number : \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You can also directly start the resource wizard by the command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi new app","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 3:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"And if you are inside a app folder, the app you want to create the resource for, is already pre-selected for you.","type":"text"}]},{"type":"codeBlock","content":[{"text":"~ pipeforce> cd properties/global/app/myapp\n~ app/myapp> pi new pipeline","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi pipeline","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-pipeline"}}]}]},{"type":"paragraph","content":[{"text":"This executes a a locally stored pipeline file, a remote pipeline or a pipeline uri. Which type of pipeline is detected by the pipeline argument:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Starts with ","type":"text"},{"text":"properties/","type":"text","marks":[{"type":"code"}]},{"text":" (or the name configured as propertiesHome in ","type":"text"},{"text":"./pipeforce/config.json","type":"text","marks":[{"type":"code"}]},{"text":"): It's assumed to be a local pipeline file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Starts with ","type":"text"},{"text":"global/","type":"text","marks":[{"type":"code"}]},{"text":": It's assumed to be a persisted remote pipeline.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"None of the above: It's assumed to be a pipeline uri.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi pipeline properties/global/app/myapp/pipeline/helloworld.pi.yaml","type":"text"}]},{"type":"paragraph","content":[{"text":"This example uploads the content of the ","type":"text"},{"text":"helloworld.pi.yaml","type":"text","marks":[{"type":"code"}]},{"text":" to the server, executes it there, and returns the result. It doesn't store the pipeline at server-side.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi pipeline global/app/myapp/pipeline/helloworld.pi.yaml","type":"text"}]},{"type":"paragraph","content":[{"text":"This example executes a persisted pipeline stored at the key path ","type":"text"},{"text":"global/app/myapp/pipeline/helloworld.pi.yaml","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 3:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi pipeline \"log?message=HELLO\"","type":"text"}]},{"type":"paragraph","content":[{"text":"This example takes the given pipeline uri and executes it at server side.","type":"text"}]},{"type":"paragraph","content":[{"text":"The syntax of a pipeline uri looks like this:","type":"text"}]},{"type":"paragraph","content":[{"text":"[?=&=","type":"text","marks":[{"type":"code"}]},{"text":"]","type":"text"}]},{"type":"paragraph","content":[{"text":"It is also possible to combine multiple commands to form a pipeline using the pipe ","type":"text"},{"text":"|","type":"text","marks":[{"type":"code"}]},{"text":" character:","type":"text"}]},{"type":"paragraph","content":[{"text":"?=&=|?=&=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Here is an example to re-write this YAML pipeline configuration:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"yaml"},"content":[{"text":"pipeline:\n - datetime:\n format: \"dd.MM.YY\"\n - log:","type":"text"}]},{"type":"paragraph","content":[{"text":"To this pipeline uri format:","type":"text"}]},{"type":"codeBlock","content":[{"text":"datetime?format=dd.MM.YY|log","type":"text"}]},{"type":"paragraph","content":[{"text":"Therefore, a call of this pipeline uri would look like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi pipeline \"datetime?format=dd.MM.YY|log\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text"}]},{"type":"codeBlock","content":[{"text":"23.01.21","type":"text"}]},{"type":"paragraph","content":[{"text":"The idea of a pipeline uri is to adhoc execute commands without the need to create a pipeline file and/or upload it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also, see the CLI command ","type":"text"},{"text":"pi help command","type":"text","marks":[{"type":"code"}]},{"text":", which lists all available pipeline commands and their description you can use to build pipelines and pipeline uris.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi publish","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-publish"}}]}]},{"type":"paragraph","content":[{"text":"This uploads your created or changed resources like pipeline or form configurations to the server.","type":"text"}]},{"type":"paragraph","content":[{"text":"In case a resource already exists at the server, this updates only if it has changed since last upload.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi publish","type":"text"}]},{"type":"paragraph","content":[{"text":"This command uploads / updates all resources inside the ","type":"text"},{"text":"properties","type":"text","marks":[{"type":"code"}]},{"text":" folder.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you want to publish only a certain subset of the properties folder, you can specify the folder like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish properties/global/app/myapp/**","type":"text"}]},{"type":"paragraph","content":[{"text":"This will recursively publish any resource inside this folder and its sub-folders.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 3:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"In case you want to publish only the files inside this folder, but not its sub-folders and files, you can use a single asterisk instead:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish properties/global/app/myapp/*","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 4:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you want to publish a single resource, define it by its filename:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish properties/global/app/myapp/pipeline/hello.pi.yaml","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 5:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Note, that the path argument is always relatively to your current working dir, as long as you are inside the workspace home folder $USER_HOME/pipeforce:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd $USER_HOME/pipeforce/properties/global/app/myapp\npi publish **","type":"text"}]},{"type":"paragraph","content":[{"text":"This will publish all resources inside ","type":"text"},{"text":"properties/gobal/app/myapp","type":"text","marks":[{"type":"code"}]},{"text":" recursively.","type":"text"}]},{"type":"paragraph","content":[{"text":"For security reasons (for example, to not accidentally publish a huge path structure of your file system to the server), publish is only possible in case your current working dir is inside the workspace folder.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi setup","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-setup"}}]}]},{"type":"paragraph","content":[{"text":"This changes the settings of the CLI tool using a wizard and/or installs the CLI if not already done.","type":"text"}]},{"type":"paragraph","content":[{"text":"This writes the final result into the file ","type":"text"},{"text":"$USER_HOME/pipeforce/pipeforce-cli/conf/cli.conf.json","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For more advanced users, you can use the advanced flag in order to be able to adjust more settings:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi setup advanced","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi status","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-status"}}]}]},{"type":"paragraph","content":[{"text":"This returns status information about the CLI.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi status","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi sync","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-sync"}}]}]},{"type":"paragraph","content":[{"text":"This does a one-way-sync of files inside the local ","type":"text"},{"text":"properties","type":"text","marks":[{"type":"code"}]},{"text":" folder to the server. It watches a given folder, and immediately syncs changes of files inside this folder to the server.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The folder to sync must be located inside the ","type":"text"},{"text":"properties","type":"text","marks":[{"type":"code"}]},{"text":" folder of your workspace.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi sync properties/global/app/myapp","type":"text"}]},{"type":"paragraph","content":[{"text":"This example syncs all files from the folder ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":" to the server.","type":"text"}]},{"type":"paragraph","content":[{"text":"At the beginning of the sync, you will be asked whether you want to backup and cleanup the given folder. If you choose ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"code"}]},{"text":", then the content of the remote folder will be downloaded and stored in your workspace inside the ","type":"text"},{"text":"backup","type":"text","marks":[{"type":"code"}]},{"text":" folder, and then the remote content gets deleted. This is handy in case you want to start with a clean sync state between local and server side.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This is a one-way-sync from local to server. Changes made on the server-side will not be merged to your local sources. If you need such an approach, please refer to source managament tools like Git, for example, which have built-in merge conflict handling and concurrent editing features.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi update","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-update"}}]}]},{"type":"paragraph","content":[{"text":"This looks for an update of the CLI and installs it if a newer version exists.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi update","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Kubernetes Commands","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#kubernetes-commands"}}]}]},{"type":"paragraph","content":[{"text":"Since version v3.0.13 the CLI also contains some useful commands in order to make it easier to work with the Kubernetes backend of PIPEFORCE. These commands are intended mainly to simplify the development for backend developers and DevOps.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to be able to use these extended commands, ","type":"text"},{"text":"kubectl","type":"text","marks":[{"type":"link","attrs":{"href":"https://kubernetes.io/docs/tasks/tools/"}}]},{"text":" must be installed and its current context must be configured in a way to successfully access to the Kubernetes cluster, the commands must be targeted to.","type":"text"}]},{"type":"paragraph","content":[{"text":"All commands specific to Kubernetes are prefixed with a ","type":"text"},{"text":"k","type":"text","marks":[{"type":"code"}]},{"text":" for example ","type":"text"},{"text":"kupload","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"All k-commands are executed inside the namespace of the currently active instance, selected by ","type":"text"},{"text":"pi setup","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"pi instance","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi kdownload","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-kdownload"}}]}]},{"type":"paragraph","content":[{"text":"Downloads a file or folder (recursively) from a container inside Kubernetes to the local file system. Automatically selects the container by resolving the given service name.","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi kdownload ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi kdownload hub /srv/ /Users/user1/","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"FOR WINDOWS USERS","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure to not use backslashes ","type":"text"},{"text":"\\","type":"text","marks":[{"type":"code"}]},{"text":" or drive letters like ","type":"text"},{"text":"C:","type":"text","marks":[{"type":"code"}]},{"text":"for example in your path. You have to rewrite a path like ","type":"text"},{"text":"C:\\myfolder","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"C/myfolder","type":"text","marks":[{"type":"code"}]},{"text":" or simply ","type":"text"},{"text":"/myfolder","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi kexec","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-kexec"}}]}]},{"type":"paragraph","content":[{"text":"Executes a command inside a container within Kubernetes. Automatically selects the container by resolving the given service name.","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi kexec -- ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi kexec hub -- ls -l","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi kpodname","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-kpodname"}}]}]},{"type":"paragraph","content":[{"text":"Automatically detects the internal pod names for a given PIPEFORCE service name and returns them.","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi kpodname ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi kpodname hub","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi ksync","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-ksync"}}]}]},{"type":"paragraph","content":[{"text":"Syncs file and folder changes (create, modify, delete) inside a local folder (recursively) with the remote folder in a container. Automatically selects the container by resolving the given service name.","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi ksync []","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi ksync drive /Users/me/git/drive/ /var/www/html www-data:root","type":"text"}]},{"type":"paragraph","content":[{"text":"This example (one-way) syncs any local changes to the remote container and applies a ","type":"text"},{"text":"chown","type":"text","marks":[{"type":"code"}]},{"text":" with ","type":"text"},{"text":"www-data:root","type":"text","marks":[{"type":"code"}]},{"text":" recursively on the synced sources.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"FOR WINDOWS USERS","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure to not use backslashes ","type":"text"},{"text":"\\","type":"text","marks":[{"type":"code"}]},{"text":" or drive letters like ","type":"text"},{"text":"C:","type":"text","marks":[{"type":"code"}]},{"text":"for example in your path. You have to rewrite a path like ","type":"text"},{"text":"C:\\myfolder","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"C/myfolder","type":"text","marks":[{"type":"code"}]},{"text":" or simply ","type":"text"},{"text":"/myfolder","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pi kupload","type":"text","marks":[{"type":"code"}]},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#pi-kupload"}}]}]},{"type":"paragraph","content":[{"text":"Uploads a file or folder (recursively) from local file system to a container inside Kubernetes. Automatically selects the container by resolving the given service name.","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi kupload ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"pi kupload hub /Users/user1/ /srv/ ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"FOR WINDOWS USERS","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure to not use backslashes ","type":"text"},{"text":"\\","type":"text","marks":[{"type":"code"}]},{"text":" or drive letters like ","type":"text"},{"text":"C:","type":"text","marks":[{"type":"code"}]},{"text":"for example in your path. You have to rewrite a path like ","type":"text"},{"text":"C:\\myfolder","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"C/myfolder","type":"text","marks":[{"type":"code"}]},{"text":" or simply ","type":"text"},{"text":"/myfolder","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Local Development","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#local-development"}}]}]},{"type":"paragraph","content":[{"text":"PIPEFORCE gives you full source code control on any of your application resources. This way you can put also the low code sources under GitOps control the same way you would do with any other source code.","type":"text"}]},{"type":"paragraph","content":[{"text":"The local low-code workspace is a folder on your local machine, where you can store and edit all of your low-code configuration files and scripts, and then sync them with the PIPEFORCE property store with a single call of ","type":"text"},{"text":"pi publish","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"You could manage all properties in the property store with the ","type":"text"},{"text":"property.*","type":"text","marks":[{"type":"code"}]},{"text":" commands and the CLI using ","type":"text"},{"text":"pi pipeline","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"This might be useful for small changes. But, if you want to develop and customize full business applications, we recommend you to use the local low-code workspace. This way you can track changes more easily and be prepared for a good change management process.","type":"text"}]},{"type":"paragraph","content":[{"text":"The low-code workspace will mirror the property store properties as a local hierarchy of folders and files. Any configuration and script file created locally inside this workspace, can then easily be uploaded to the property store with a single command. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish properties/global/app/myapp/*","type":"text"}]},{"type":"paragraph","content":[{"text":"This scans the folder ","type":"text"},{"text":"myapp","type":"text","marks":[{"type":"code"}]},{"text":" inside the workspace, and uploads only those resources which have been changed since last upload or have been created since then.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also use the short form of the command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish ","type":"text"}]},{"type":"paragraph","content":[{"text":"This will publish any new or changes resources inside the ","type":"text"},{"text":"properties","type":"text","marks":[{"type":"code"}]},{"text":" folder to the server.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#prerequisites"}}]}]},{"type":"paragraph","content":[{"text":"To set-up your local low-code workspace, you need to first download and install the CLI as described here: ","type":"text"},{"text":"Downloads","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/downloads"}}]}]},{"type":"paragraph","content":[{"text":"Furthermore, we recommend you to download and install the free source code editor Visual Studio Code (as explained in the above link)","type":"text"}]},{"type":"paragraph","content":[{"text":"Even if you have a different favorite editor, we recommend you start with this one, since it is easier to follow all of the examples. Later, you can switch to a different editor if you want.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Link to your instance","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#setup-your-instance"}}]}]},{"type":"paragraph","content":[{"text":"After you have installed the CLI, you can link to the remote PIPEFORCE instance you would like to use. Start the setup with this command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi setup","type":"text"}]},{"type":"paragraph","content":[{"text":"This will ask you a few questions to set-up the workspace correctly.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Namespace [None]:","type":"text"}]},{"type":"paragraph","content":[{"text":"Here, you need to type-in the namespace of your PIPEFORCE instance, which is typically the name of your company. If you’re not sure what your namespace is, ask ","type":"text"},{"text":"support@pipeforce.io","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:support@pipeforce.io"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Typically the namespace is the ","type":"text"},{"text":"NAMESPACE","type":"text","marks":[{"type":"strong"}]},{"text":" part of your instance url (not the full url!):","type":"text"},{"type":"hardBreak"},{"text":"https://","type":"text"},{"text":"NAMESPACE","type":"text","marks":[{"type":"strong"}]},{"text":".pipeforce.net","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if your instance url is ","type":"text"},{"text":"https://","type":"text","marks":[{"type":"link","attrs":{"href":"https://acme.pipeforce.net/"}}]},{"text":"acme","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://acme.pipeforce.net/"}}]},{"text":".pipeforce.net","type":"text","marks":[{"type":"link","attrs":{"href":"https://acme.pipeforce.net/"}}]},{"text":", then your namespace would be ","type":"text"},{"text":"acme","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Type this name in, and then press enter.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Username [None]:","type":"text"}]},{"type":"paragraph","content":[{"text":"Type-in your username.","type":"text"}]},{"type":"codeBlock","content":[{"text":"Password []:","type":"text"}]},{"type":"paragraph","content":[{"text":"Type-in your password to login into the system.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Your password is never stored by the CLI for security reasons. Instead, the CLI automatically exchanges this password with an API access token and stores this access token. This token is valid for 30 days. That means: If you did not login into PIPEFORCE for longer than 30 days, you need to re-generate this access token. You can do that by simply calling ","type":"text"},{"text":"pi setup","type":"text","marks":[{"type":"code"}]},{"text":" later, which asks again for credentials, and then creates and stores a new access token for you if the login was successful.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Congratulations! A new property store workspace was been created for you under","type":"text"},{"type":"hardBreak"},{"text":"$USER_HOME/pipeforce","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"$USER_HOME","type":"text","marks":[{"type":"code"}]},{"text":" by the path of your user home folder, which differs depending on your current operating system.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Windows, this is typically: ","type":"text"},{"text":"C:\\Users\\YOUR_USERNAME","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Mac, this is typically: ","type":"text"},{"text":"/Users/YOUR_USERNAME","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a new workspace","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#create-a-new-workspace"}}]}]},{"type":"paragraph","content":[{"text":"After you have installed the CLI and setup a PIPEFORCE instance, you can create a local workspace. Inside this workspace you can store all resources which must be deployed later to PIPEFORCE.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this, create an empty folder at a location of your choice and change into this folder. Then run ","type":"text"},{"text":"pi init","type":"text","marks":[{"type":"code"}]},{"text":" inside this folder:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mkdir myworkspace\ncd myworkspace\npi init","type":"text"}]},{"type":"paragraph","content":[{"text":"This will create all the required file and folder structure for you inside your workspace folder.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also see the ","type":"text"},{"text":"pi init","type":"text","marks":[{"type":"code"}]},{"text":" command above for more details.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to start development in VS code, type-in this command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd myworkspace\ncode .","type":"text"}]},{"type":"paragraph","content":[{"text":"This will open the workspace in VS code and you can start developing your custom apps.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can start for example by creating a new app using the command ","type":"text"},{"text":"pi new app","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configure the workspace","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#configure-the-workspace"}}]}]},{"type":"paragraph","content":[{"text":"Each workspace may contain the file ","type":"text"},{"text":".pipeforce/config.json","type":"text","marks":[{"type":"code"}]},{"text":" which contains all settings for your local workspace. If this file is missing, the default values will be used instead. This file will by default look like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"propertiesHome\": \"properties\",\n \"requiredVersion\": null,\n \"deployWithExtension\": true\n}\n","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"propertiesHome","type":"text","marks":[{"type":"code"}]},{"text":" defines the name of the folder at root of the worspace which contains all property sources which will be deployed to the PIPEFORCE backend. By default this is set to ","type":"text"},{"text":"properties","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"requiredVersion","type":"text","marks":[{"type":"code"}]},{"text":" defines the minimum version of the PIPEFORE backend which is required in order to run the apps defined in this workspace. For example ","type":"text"},{"text":"9.0.0","type":"text","marks":[{"type":"code"}]},{"text":" or just ","type":"text"},{"text":"9","type":"text","marks":[{"type":"code"}]},{"text":". If this value is empty or null, specific version check will be done. This will be checked in case the workspace apps are installed using the command ","type":"text"},{"text":"app.install","type":"text","marks":[{"type":"code"}]},{"text":" or via marketplace. Default value is ","type":"text"},{"text":"null","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"deployWithExtension","type":"text","marks":[{"type":"code"}]},{"text":" defines whether the filename extensions of the files from inside the propertiesHome folder should be kept in the property path on deployment to the property store or not. For example a file in ","type":"text"},{"text":"properties/global/app/config/app.json","type":"text","marks":[{"type":"code"}]},{"text":" will be deployed to a property path ","type":"text"},{"text":"global/app/config/app.json","type":"text","marks":[{"type":"code"}]},{"text":" if this value is set to true, or to ","type":"text"},{"text":"global/app/config/app","type":"text","marks":[{"type":"code"}]},{"text":" if this value is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":". Default is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Visual Studio Code","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#using-visual-studio-code"}}]}]},{"type":"paragraph","content":[{"text":"Visual Studio Code (in short: VS Code) is a free resource editor which works nicely together with the pi tool and simplifies customizing PIPEFORCE. You can also use a different editor, but we recommend you to use this one at least for the starting phase.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Download and Installation","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#download-and-installation"}}]}]},{"type":"paragraph","content":[{"text":"You can download Visual Studio Code for free here: ","type":"text"},{"text":"https://code.visualstudio.com/download","type":"text","marks":[{"type":"link","attrs":{"href":"https://code.visualstudio.com/download"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Loading the workspace in VS Code","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#loading-the-workspace-in-vs-code"}}]}]},{"type":"paragraph","content":[{"text":"After you have created a new PIPEFORCE workspace, navigate to its location:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd myworkspace","type":"text"}]},{"type":"paragraph","content":[{"text":"Inside this folder, there is a file called ","type":"text"},{"text":"PIPEFORCE.code-workspace","type":"text","marks":[{"type":"code"}]},{"text":". Double click this file in order to start the Visual Studio Code. Note: Visual Studio Code needs to be installed beforehand.","type":"text"}]},{"type":"paragraph","content":[{"text":"This will start Visual Studio Code with everything already set-up, so you can immediately start to create and deploy apps in PIPEFORCE:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":743,"id":"e27ac883-ae79-44e7-a6d2-786895bb508e","collection":"contentId-2548400334","type":"file","height":502}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Show the terminal","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#show-the-terminal"}}]}]},{"type":"paragraph","content":[{"text":"It is comfortable to also show the terminal inside of VS Code. To do so, in the top menu, click ","type":"text"},{"text":"Terminal → New Terminal","type":"text","marks":[{"type":"code"}]},{"text":". This opens a new terminal at the bottom of VS Code:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":738,"id":"0d225d1b-3540-429c-bdc1-aa890d50c2e4","collection":"contentId-2548400334","type":"file","height":501}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create a new resource","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#create-a-new-resource"}}]}]},{"type":"paragraph","content":[{"text":"You can now use the terminal to create, for example, a new pipeline by typing this command in the VS Code terminal:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":517,"id":"026dcd4f-c6fe-458b-abc7-31245b1e7648","collection":"contentId-2548400334","type":"file","height":128}}]},{"type":"paragraph","content":[{"text":"After pressing enter, you will be asked for a name of the new pipeline. Type-in ","type":"text"},{"text":"helloworld","type":"text","marks":[{"type":"code"}]},{"text":", and press enter again.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":523,"id":"1b9a1667-f329-4271-8705-2bbeadeed8df","collection":"contentId-2548400334","type":"file","height":128}}]},{"type":"paragraph","content":[{"text":"After this, a new pipeline file was created for you with the name ","type":"text"},{"text":"helloworld.pi.yaml","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"width":523,"id":"1b9a1667-f329-4271-8705-2bbeadeed8df","collection":"contentId-2548400334","type":"file","height":128}}]},{"type":"paragraph","content":[{"text":"If you open this file, you can see it contains a simple hello world demo pipeline, which logs “Hello World” into the server log, and writes it into the body.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":844,"id":"dd33d8f2-b293-43fd-b90e-ada0ebf99090","collection":"contentId-2548400334","type":"file","height":540}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Execute a pipeline in the terminal","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#execute-a-pipeline-in-the-terminal"}}]}]},{"type":"paragraph","content":[{"text":"To run the pipeline right from within your VS Code, use this command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi pipeline file properties/global/pipeline/helloworld.pi.yaml","type":"text"}]},{"type":"paragraph","content":[{"text":"You should then see the output of this pipeline in the terminal.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Enable code completion for pipelines","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#enable-code-completion-for-pipelines"}}]}]},{"type":"paragraph","content":[{"text":"In order to enable code completion for pipelines inside of VS Code, you can optionally install the free YAML plugin from the Microsoft VS Code marketplace.","type":"text"}]},{"type":"paragraph","content":[{"text":"Open this url in your browser:","type":"text"},{"type":"hardBreak"},{"text":"https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml","type":"text","marks":[{"type":"link","attrs":{"href":"https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml"}}]}]},{"type":"paragraph","content":[{"text":"Click install. Allow this link to open with VS Code, if requested.","type":"text"}]},{"type":"paragraph","content":[{"text":"Now, you should be able to use pipeline code completion.","type":"text"}]},{"type":"paragraph","content":[{"text":"To test it, add a new command in the ","type":"text"},{"text":"helloworld.pi.yaml","type":"text","marks":[{"type":"code"}]},{"text":" file. After you started typing, you should get a suggestion list of all available pipeline commands including inline documentation:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":854,"id":"f933a538-c23a-4a4f-b336-9b9a629af317","collection":"contentId-2548400334","type":"file","height":540}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Publish a resource","type":"text"},{"text":"","type":"text","marks":[{"type":"link","attrs":{"href":"https://pipeforce.github.io/docs/cli#publish-a-resource"}}]}]},{"type":"paragraph","content":[{"text":"After you have created a resource locally, you can upload it to the property store with a simple command inside your VS Code terminal:","type":"text"}]},{"type":"codeBlock","content":[{"text":"pi publish","type":"text"}]},{"type":"paragraph","content":[{"text":"After the command was executed, you can see that your pipeline has been successfully uploaded into the property store.","type":"text"}]},{"type":"paragraph","content":[{"text":"Anytime you change a resource in the workspace, calling ","type":"text"},{"text":"pi publish","type":"text","marks":[{"type":"code"}]},{"text":" afterwards, will create or update only those resources which have been changed after the last publish. This way, you can work in a very effective way.","type":"text"}]}],"version":1}

Browser not supported