https://github.com/digitalocean/sample-functions-nodejs-helloworld
https://github.com/digitalocean/sample-functions-nodejs-helloworld
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/digitalocean/sample-functions-nodejs-helloworld
- Owner: digitalocean
- Created: 2022-02-14T12:53:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-02-26T03:58:48.000Z (over 2 years ago)
- Last Synced: 2025-01-15T00:20:05.149Z (over 1 year ago)
- Language: JavaScript
- Size: 53.7 KB
- Stars: 34
- Watchers: 19
- Forks: 110
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Sample Function: Node.js "Hello World"
## Introduction
This repository contains a sample function written in Node.js JavaScript. You can deploy it on DigitalOcean's App Platform as a Serverless Function component or as a standalone Function. Documentation is available at https://docs.digitalocean.com/products/functions.
### Requirements
* You need a DigitalOcean account. If you don't already have one, you can sign up at [https://cloud.digitalocean.com/registrations/new](https://cloud.digitalocean.com/registrations/new).
* To deploy from the command line, you will need the [DigitalOcean `doctl` CLI](https://github.com/digitalocean/doctl/releases).
## Deploying the Function
```
# clone this repo
git clone git@github.com:digitalocean/sample-functions-nodejs-helloworld.git
```
```
# deploy the project, using a remote build so that compiled executable matched runtime environment
doctl serverless deploy sample-functions-nodejs-helloworld --remote-build
```
The output from the deploy command will resemble the following.
```
Deploying 'sample-functions-nodejs-helloworld'
to namespace 'fn-...'
on host '...'
Submitted function 'sample/hello' for remote building and deployment in runtime nodejs:default (id: ...)
Processing of action 'sample/hello' is still running remotely ...
Deployment status recorded in 'sample-functions-nodejs-helloworld/.deployed'
Deployed functions ('doctl sls fn get --url' for URL):
- sample/hello
```
## Using the Function
```
doctl serverless functions invoke sample/hello
```
This will return the default response from the function.
```
{
"body": "Hello stranger!"
}
```
You can pass a parameter to your function using the `-p` command line argument.
```
doctl serverless functions invoke sample/hello -p name:functions
{
"body": "Hello functions!"
}
```
Use this command to retrieve the URL for your function and use it as an API.
```
doctl sls fn get sample/hello --url
```
You can use that API directly in your browser, with `curl` or with an API platform such as Postman.
Parameters may be passed as query parameters, or as JSON body. Here are some examples using `curl`.
```
curl `doctl sls fn get sample/hello --url`?name=query
```
```
curl -H 'Content-Type: application/json' -d '{"name":"body"}' `doctl sls fn get sample/hello --url`
```
### Learn More
You can learn more about Functions by reading the [Functions Documentation](https://docs.digitalocean.com/products/functions).