Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apache/openwhisk-vscode-extension
VSCode extension for Apache OpenWhisk
https://github.com/apache/openwhisk-vscode-extension
apache cloud dev-tools faas functions-as-a-service openwhisk serverless serverless-architectures serverless-functions vscode-extension
Last synced: 7 days ago
JSON representation
VSCode extension for Apache OpenWhisk
- Host: GitHub
- URL: https://github.com/apache/openwhisk-vscode-extension
- Owner: apache
- License: apache-2.0
- Created: 2021-01-12T05:47:14.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-01-19T06:10:34.000Z (about 1 year ago)
- Last Synced: 2024-10-01T01:22:10.358Z (4 months ago)
- Topics: apache, cloud, dev-tools, faas, functions-as-a-service, openwhisk, serverless, serverless-architectures, serverless-functions, vscode-extension
- Language: TypeScript
- Homepage: https://openwhisk.apache.org/
- Size: 977 KB
- Stars: 11
- Watchers: 28
- Forks: 8
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# OpenWhisk VS Code Extension
An **openwhisk-vscode-extension** is an open-source VS Code extension for [Apache OpenWhisk](https://openwhisk.apache.org/). It manages the wskdeploy manifest file and makes deployment easy. You can also create and update actions and packages in VS Code.
Try creating and editing your action code in the VS Code!
## Prerequisites
Install the dependencies below to use full features:
- [vscode](https://code.visualstudio.com/) >= 1.41.0
- [wskdeploy](https://github.com/apache/openwhisk-wskdeploy/releases)
This extension finds the `.wskprops` configuration file located in the home path and connects to the Openwhisk server automatically. Set up your configuration referred to the [cli docs](https://github.com/apache/openwhisk/blob/master/docs/cli.md#openwhisk-cli).
## Features
### OpenWhisk Explorer
- Explore all entities in your endpoints/namespaces.
- The .wskprops file is automatically registered.
- You can add the API host manually.
- You can add the namespace manually by API auth key.
- Show the action code with syntax highlighting.
- Edit the action code on the remote server.
- Invoke the action remotely and get the activation result.
- Show a list of actions related to the sequence action.
- Show information about the trigger and related rules.
- Show activations related to the action (Same as `wsk activation list `).
- Show detailed information of the activation (Same as `wsk activation get `).
- Update parameters and annotations of the action, package, and trigger.
### Manifest View (in the workspace explorer)
- List up manifest YAML files in the workspace.
- Deploy/Undeploy OpenWhisk packages with manifest (via wskdeploy).
- Deploy with the deployment file.
- Deploy with multiple credentials.
## Commands
This extension contributes the following commands to the Command palette.
- `Create a wskdeploy project`: creates a wskdeploy project
## How to debug in your local environment
### Requirements
- [vscode](https://code.visualstudio.com/) >= 1.41.0
- [Node.js](https://nodejs.org/en/download/) >= 12.x
- Have an OpenWhisk deployment available, which you set up by following this [guide](https://openwhisk.apache.org/documentation.html#pre-requisites) or by using one of the managed OpenWhisk offerings (e.g., from IBM, Adobe or Nimbella). Note, deployments with self signed SSL certificates may not work with this extension.
### Set up
1. Clone the repository:
```bash
git clone https://github.com/apache/openwhisk-vscode-extension.git
code ./openwhisk-vscode-extension # Open openwhisk-vscode-extension in VS Code
```
2. In your terminal, execute the command `npm install` to install extension dependencies
3. In your terminal, execute the command `npm run webpack-dev` to start up the extension builder in watch mode (allows for making changes to files and rebuilding automatically)
4. Open up the `src/extension.ts` file for editing
5. In the `src/extension.ts` file press `F5` button to start debugger and select `VS Code Extension Development` if a modal appears at the top of the VS Code window
6. Interact with the `DEBUG CONSOLE` for real time debugging of the extension and learn more about debugging [here](https://github.com/apache/openwhisk-vscode-extension/blob/master/vsc-extension-quickstart.md)
## License
```
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```
## Third-party Product Acknowledgement
Portions of this product include SVG files developed by the XEIcon project (https://github.com/xpressengine/XEIcon).
- Dark theme: https://github.com/apache/openwhisk-vscode-extension/tree/master/resource/dark
- Light theme: https://github.com/apache/openwhisk-vscode-extension/tree/master/resource/light
Those files are distributed under the XEIcon license (https://github.com/xpressengine/XEIcon#license).