diff --git a/CHANGELOG.md b/CHANGELOG.md index 02f4d8117b6..106982a1b80 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). +## [v2.49.0](https://github.com/netlify/cli/compare/v2.48.0...v2.49.0) - 2020-05-06 + +### Merged + +- functions:invoke: Fix config problems by adding port flag [`#878`](https://github.com/netlify/cli/pull/878) +- GitHub Actions debug [`#875`](https://github.com/netlify/cli/pull/875) +- Allow users to unlock deployments while deploying [`#844`](https://github.com/netlify/cli/pull/844) +- Fixed some documentation typos in netlify-dev.md. [`#871`](https://github.com/netlify/cli/pull/871) +- Upgrade Netlify Build [`#874`](https://github.com/netlify/cli/pull/874) +- Netlify Dev: Add framework = "#custom" option [`#843`](https://github.com/netlify/cli/pull/843) +- Fix typo. [`#873`](https://github.com/netlify/cli/pull/873) +- Use .app for the site's name suggestion message. [`#864`](https://github.com/netlify/cli/pull/864) +- Upgrade `zip-it-and-ship-it` [`#867`](https://github.com/netlify/cli/pull/867) +- Upgrade Netlify Build [`#866`](https://github.com/netlify/cli/pull/866) +- Run Prettier [`#861`](https://github.com/netlify/cli/pull/861) +- Upgrade Netlify Build [`#860`](https://github.com/netlify/cli/pull/860) + +### Commits + +- Test CRA: Use npm instead of yarn [`4eb20cd`](https://github.com/netlify/cli/commit/4eb20cdeacc8df8bca1cf6db8a497904a5b13751) +- GH Actions: Steamline tests [`9de46c4`](https://github.com/netlify/cli/commit/9de46c460830e73b75663fd31380ef951cbff8cf) +- Improve a log [`55c2992`](https://github.com/netlify/cli/commit/55c2992649fe398480524be8f90779343be8ade0) + ## [v2.48.0](https://github.com/netlify/cli/compare/v2.47.0...v2.48.0) - 2020-04-24 ### Merged @@ -118,7 +141,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). - Make sure to respect port flags and configuration [`#755`](https://github.com/netlify/cli/pull/755) - Add support for getting/tailing deploy logs [`#762`](https://github.com/netlify/cli/pull/762) - Deploy: Add flag to trigger build [`#760`](https://github.com/netlify/cli/pull/760) -- Add support for \_headers files [`#754`](https://github.com/netlify/cli/pull/754) +- Add support for _headers files [`#754`](https://github.com/netlify/cli/pull/754) - Upgrade `@netlify/build` [`#761`](https://github.com/netlify/cli/pull/761) ## [v2.40.0](https://github.com/netlify/cli/compare/v2.39.0...v2.40.0) - 2020-03-16 @@ -537,7 +560,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). ### Commits -- RulesProxy: Make sure \_redirects works with dev [`27f92f2`](https://github.com/netlify/cli/commit/27f92f23148f7250e63a1586744d155a54751cd5) +- RulesProxy: Make sure _redirects works with dev [`27f92f2`](https://github.com/netlify/cli/commit/27f92f23148f7250e63a1586744d155a54751cd5) - update logo [`3984bbb`](https://github.com/netlify/cli/commit/3984bbb1c4177fb410f9100d83baac7875ea0025) - Dev: Make stdio more maintainable [`4cbdb02`](https://github.com/netlify/cli/commit/4cbdb02ca85c7680b9c469aad5ce725e3975f86f) @@ -549,11 +572,11 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). - Dev: Make functions port configureable [`#525`](https://github.com/netlify/cli/pull/525) - Fix port for proxy redirects [`#520`](https://github.com/netlify/cli/pull/520) - Rules Proxy: Pass on query parameters [`#519`](https://github.com/netlify/cli/pull/519) -- Import rules-proxy and and redirect-parser [`#518`](https://github.com/netlify/cli/pull/518) +- Import rules-proxy and and redirect-parser [`#518`](https://github.com/netlify/cli/pull/518) - Consider sites from different team in Netlify link [`#500`](https://github.com/netlify/cli/pull/500) - Improve prompts for `link` command [`#502`](https://github.com/netlify/cli/pull/502) - Add Parcel detector [`#505`](https://github.com/netlify/cli/pull/505) -- rename deploy path [`#508`](https://github.com/netlify/cli/pull/508) +- rename deploy path [`#508`](https://github.com/netlify/cli/pull/508) - Improve analytics [`#513`](https://github.com/netlify/cli/pull/513) - Update ISSUE_TEMPLATE.md [`#504`](https://github.com/netlify/cli/pull/504) - Neltify -> Netlify [`#512`](https://github.com/netlify/cli/pull/512) @@ -903,7 +926,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). - update netlify dev plugin [`514d759`](https://github.com/netlify/cli/commit/514d7591609fbd645c1de87f47200099e6919abe) - Add a test for raw parsing [`deb4cb9`](https://github.com/netlify/cli/commit/deb4cb97cf0ef12efba83b07c719064e9e16342e) -- Use conventional file casing [`60ad9d0`](https://github.com/netlify/cli/commit/60ad9d07c5a43ea24e78b63d70955e1a11dacc13) +- Use conventional file casing [`60ad9d0`](https://github.com/netlify/cli/commit/60ad9d07c5a43ea24e78b63d70955e1a11dacc13) ## [v2.11.7](https://github.com/netlify/cli/compare/v2.11.6...v2.11.7) - 2019-04-10 @@ -1117,7 +1140,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). ### Commits - Run `npm up` [`29f16fa`](https://github.com/netlify/cli/commit/29f16fa376a55093b09d0c14a67e6ab68a5718f7) -- Update js-client providing zip-n-ship capabilities [`f9774a2`](https://github.com/netlify/cli/commit/f9774a29781c37d10875563c6221c2b92d2d7800) +- Update js-client providing zip-n-ship capabilities [`f9774a2`](https://github.com/netlify/cli/commit/f9774a29781c37d10875563c6221c2b92d2d7800) - Update deps [`985e8da`](https://github.com/netlify/cli/commit/985e8da37e162fefabfd27ac5bf6e567ba7ea790) ## [v2.6.6](https://github.com/netlify/cli/compare/v2.6.5...v2.6.6) - 2019-01-31 @@ -1128,7 +1151,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). ### Commits -- Run prune before shrink-wrap [`761fcc5`](https://github.com/netlify/cli/commit/761fcc5660c8ac2a293afde661a129a0c8fbee84) +- Run prune before shrink-wrap [`761fcc5`](https://github.com/netlify/cli/commit/761fcc5660c8ac2a293afde661a129a0c8fbee84) ## [v2.6.5](https://github.com/netlify/cli/compare/v2.6.4...v2.6.5) - 2019-01-31 @@ -1165,7 +1188,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). ### Commits -- Update js-client to fix rate limit handling [`32590eb`](https://github.com/netlify/cli/commit/32590ebf2aa9788733908afee3aefd87f21e9bb8) +- Update js-client to fix rate limit handling [`32590eb`](https://github.com/netlify/cli/commit/32590ebf2aa9788733908afee3aefd87f21e9bb8) ## [v2.6.2](https://github.com/netlify/cli/compare/v2.6.1...v2.6.2) - 2019-01-19 @@ -1255,7 +1278,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). ### Commits -- Fix missing dependencies [`4dd06ad`](https://github.com/netlify/cli/commit/4dd06ad5bf53d62355e2f126bcc641786dba4139) +- Fix missing dependencies [`4dd06ad`](https://github.com/netlify/cli/commit/4dd06ad5bf53d62355e2f126bcc641786dba4139) ## [v2.2.2](https://github.com/netlify/cli/compare/v2.2.1...v2.2.2) - 2018-11-26 @@ -1379,7 +1402,7 @@ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog). ### Commits - add root to this.netlify.site [`9104cf2`](https://github.com/netlify/cli/commit/9104cf2df283e19b4565daeb7f9c7a695a5bc419) -- Use dirname, not base name [`73b594c`](https://github.com/netlify/cli/commit/73b594c1bb8dc024ecca8d1a1c9a42ab0b953317) +- Use dirname, not base name [`73b594c`](https://github.com/netlify/cli/commit/73b594c1bb8dc024ecca8d1a1c9a42ab0b953317) ## [v2.0.0-beta.8](https://github.com/netlify/cli/compare/v2.0.0-beta.7...v2.0.0-beta.8) - 2018-10-09 diff --git a/README.md b/README.md index 7590e23736c..46bf1e59b67 100644 --- a/README.md +++ b/README.md @@ -16,21 +16,21 @@ See the [CLI command line reference](https://cli.netlify.com/commands/) to get s - [Usage](#usage) - [Documentation](#documentation) - [Commands](#commands) - - [addons](#addons) - - [api](#api) - - [build](#build) - - [deploy](#deploy) - - [dev](#dev) - - [functions](#functions) - - [init](#init) - - [link](#link) - - [login](#login) - - [open](#open) - - [sites](#sites) - - [status](#status) - - [switch](#switch) - - [unlink](#unlink) - - [watch](#watch) + * [addons](#addons) + * [api](#api) + * [build](#build) + * [deploy](#deploy) + * [dev](#dev) + * [functions](#functions) + * [init](#init) + * [link](#link) + * [login](#login) + * [open](#open) + * [sites](#sites) + * [status](#status) + * [switch](#switch) + * [unlink](#unlink) + * [watch](#watch) - [Contributing](#contributing) - [Development](#development) - [License](#license) @@ -68,18 +68,18 @@ For a full command reference, see the list below, or visit [cli.netlify.com](htt ## Commands - ### [addons](/docs/commands/addons.md) (Beta) Manage Netlify Add-ons -| Subcommand | description | -| :------------------------------------------------------- | :---------------------------------------- | -| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | -| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | -| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | -| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | -| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | +| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | +| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | +| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | +| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | + ### [api](/docs/commands/api.md) @@ -97,19 +97,21 @@ Create a new deploy from the contents of a folder Local dev server -| Subcommand | description | -| :------------------------------------------ | :----------- | -| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | +| Subcommand | description | +|:--------------------------- |:-----| +| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | + ### [functions](/docs/commands/functions.md) Manage netlify functions -| Subcommand | description | -| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | -| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | -| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | -| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | +| Subcommand | description | +|:--------------------------- |:-----| +| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | +| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | +| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | + ### [init](/docs/commands/init.md) @@ -127,28 +129,31 @@ Login to your Netlify account Open settings for the site linked to the current folder -| Subcommand | description | -| :----------------------------------------------- | :------------------------------------- | -| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | -| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | +| Subcommand | description | +|:--------------------------- |:-----| +| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | +| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | + ### [sites](/docs/commands/sites.md) Handle various site operations -| Subcommand | description | -| :---------------------------------------------------- | :-------------------------------- | -| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | -| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | -| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | +| Subcommand | description | +|:--------------------------- |:-----| +| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | +| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | +| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | + ### [status](/docs/commands/status.md) Print status information -| Subcommand | description | -| :----------------------------------------------------- | :---------------------------------------- | -| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | + ### [switch](/docs/commands/switch.md) @@ -162,6 +167,7 @@ Unlink a local folder from a Netlify site Watch for site deploy to finish + ## Contributing diff --git a/docs/README.md b/docs/README.md index f55ca1c0c5e..71a1e1c09dc 100644 --- a/docs/README.md +++ b/docs/README.md @@ -34,18 +34,18 @@ netlify [command] help ## Commands - ### [addons](/docs/commands/addons.md) (Beta) Manage Netlify Add-ons -| Subcommand | description | -| :------------------------------------------------------- | :---------------------------------------- | -| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | -| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | -| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | -| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | -| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | +| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | +| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | +| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | +| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | + ### [api](/docs/commands/api.md) @@ -63,19 +63,21 @@ Create a new deploy from the contents of a folder Local dev server -| Subcommand | description | -| :------------------------------------------ | :----------- | -| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | +| Subcommand | description | +|:--------------------------- |:-----| +| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | + ### [functions](/docs/commands/functions.md) Manage netlify functions -| Subcommand | description | -| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | -| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | -| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | -| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | +| Subcommand | description | +|:--------------------------- |:-----| +| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | +| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | +| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | + ### [init](/docs/commands/init.md) @@ -93,28 +95,31 @@ Login to your Netlify account Open settings for the site linked to the current folder -| Subcommand | description | -| :----------------------------------------------- | :------------------------------------- | -| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | -| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | +| Subcommand | description | +|:--------------------------- |:-----| +| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | +| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | + ### [sites](/docs/commands/sites.md) Handle various site operations -| Subcommand | description | -| :---------------------------------------------------- | :-------------------------------- | -| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | -| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | -| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | +| Subcommand | description | +|:--------------------------- |:-----| +| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | +| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | +| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | + ### [status](/docs/commands/status.md) Print status information -| Subcommand | description | -| :----------------------------------------------------- | :---------------------------------------- | -| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | + ### [switch](/docs/commands/switch.md) @@ -128,4 +133,5 @@ Unlink a local folder from a Netlify site Watch for site deploy to finish + diff --git a/docs/commands/addons.md b/docs/commands/addons.md index 01a3668742d..276e6987bb4 100644 --- a/docs/commands/addons.md +++ b/docs/commands/addons.md @@ -11,7 +11,6 @@ For more information on add-ons see our [Netlify partner add-ons docs](https://w ## About - (Beta) Manage Netlify Add-ons **Usage** @@ -20,13 +19,14 @@ For more information on add-ons see our [Netlify partner add-ons docs](https://w netlify addons ``` -| Subcommand | description | -| :------------------------------------------------------- | :---------------------------------------- | -| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | -| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | -| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | -| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | -| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | +| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | +| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | +| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | +| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | + **Examples** @@ -39,7 +39,6 @@ netlify addons:auth addon-xyz ``` --- - ## `addons:auth` Login to add-on provider @@ -55,7 +54,6 @@ netlify addons:auth - name - Add-on slug --- - ## `addons:config` Configure add-on settings @@ -71,13 +69,13 @@ netlify addons:config - name - Add-on namespace --- - ## `addons:create` Add an add-on extension to your site ... Add-ons are a way to extend the functionality of your Netlify site + **Usage** ```bash @@ -89,13 +87,13 @@ netlify addons:create - name - Add-on namespace --- - ## `addons:delete` Remove an add-on extension to your site ... Add-ons are a way to extend the functionality of your Netlify site + **Usage** ```bash @@ -108,10 +106,9 @@ netlify addons:delete **Flags** -- `force` (_boolean_) - delete without prompting (useful for CI) +- `force` (*boolean*) - delete without prompting (useful for CI) --- - ## `addons:list` List currently installed add-ons for site @@ -124,7 +121,7 @@ netlify addons:list **Flags** -- `json` (_boolean_) - Output add-on data as JSON +- `json` (*boolean*) - Output add-on data as JSON --- diff --git a/docs/commands/api.md b/docs/commands/api.md index 740a84e8c45..dcd6bcb69b3 100644 --- a/docs/commands/api.md +++ b/docs/commands/api.md @@ -7,11 +7,11 @@ title: Netlify CLI api command The `api` command will let you call any [Netlify open API methods](https://open-api.netlify.com/) - Run any Netlify API method For more information on available methods checkout https://open-api.netlify.com/ or run "netlify api --list" + **Usage** ```bash @@ -24,8 +24,8 @@ netlify api **Flags** -- `data` (_option_) - Data to use -- `list` (_boolean_) - List out available API methods +- `data` (*option*) - Data to use +- `list` (*boolean*) - List out available API methods **Examples** @@ -34,4 +34,5 @@ netlify api --list netlify api getSite --data '{ "site_id": "123456"}' ``` + diff --git a/docs/commands/deploy.md b/docs/commands/deploy.md index 560cbe60074..f97382e74a6 100644 --- a/docs/commands/deploy.md +++ b/docs/commands/deploy.md @@ -5,7 +5,6 @@ title: Netlify CLI deploy command # `deploy` - Create a new deploy from the contents of a folder Deploys from the build settings found in the netlify.toml file, or settings from the API. @@ -17,7 +16,9 @@ The following environment variables can be used to override configuration file l Lambda functions in the function folder can be in the following configurations for deployment: -## Built Go binaries: + +Built Go binaries: +------------------ ``` functions/ @@ -26,7 +27,9 @@ functions/ Build binaries of your Go language functions into the functions folder as part of your build process. -## Single file Node.js functions: + +Single file Node.js functions: +----------------------------- Build dependency bundled Node.js lambda functions with tools like netlify-lambda, webpack or browserify into the function folder as part of your build process. @@ -35,7 +38,8 @@ functions/ └── nameOfBundledNodeJSFunction.js ``` -## Unbundled Node.js functions that have dependencies outside or inside of the functions folder: +Unbundled Node.js functions that have dependencies outside or inside of the functions folder: +--------------------------------------------------------------------------------------------- You can ship unbundled Node.js functions with the CLI, utilizing top level project dependencies, or a nested package.json. If you use nested dependencies, be sure to populate the nested node_modules as part of your build process before deploying using npm or yarn. @@ -55,7 +59,9 @@ project/ Any mix of these configurations works as well. -## Node.js function entry points + +Node.js function entry points +----------------------------- Function entry points are determined by the file name and name of the folder they are in: @@ -69,6 +75,7 @@ functions/ Support for package.json's main field, and intrinsic index.js entrypoints are coming soon. + **Usage** ```bash @@ -77,16 +84,16 @@ netlify deploy **Flags** -- `dir` (_option_) - Specify a folder to deploy -- `functions` (_option_) - Specify a functions folder to deploy -- `prod` (_boolean_) - Deploy to production -- `open` (_boolean_) - Open site after deploy -- `message` (_option_) - A short message to include in the deploy log -- `auth` (_option_) - Netlify auth token to deploy with -- `site` (_option_) - A site ID to deploy to -- `json` (_boolean_) - Output deployment data as JSON -- `timeout` (_option_) - Timeout to wait for deployment to finish -- `trigger` (_boolean_) - Trigger a new build of your site on Netlify without uploading local files +- `dir` (*option*) - Specify a folder to deploy +- `functions` (*option*) - Specify a functions folder to deploy +- `prod` (*boolean*) - Deploy to production +- `open` (*boolean*) - Open site after deploy +- `message` (*option*) - A short message to include in the deploy log +- `auth` (*option*) - Netlify auth token to deploy with +- `site` (*option*) - A site ID to deploy to +- `json` (*boolean*) - Output deployment data as JSON +- `timeout` (*option*) - Timeout to wait for deployment to finish +- `trigger` (*boolean*) - Trigger a new build of your site on Netlify without uploading local files **Examples** @@ -99,4 +106,5 @@ netlify deploy --auth $NETLIFY_AUTH_TOKEN netlify deploy --trigger ``` + diff --git a/docs/commands/dev.md b/docs/commands/dev.md index c042ab62d89..f6b73ffea9a 100644 --- a/docs/commands/dev.md +++ b/docs/commands/dev.md @@ -6,10 +6,10 @@ description: Run netlify dev locally # `dev` - Local dev server The dev command will run a local dev server with Netlify's proxy and redirect rules + **Usage** ```bash @@ -18,17 +18,18 @@ netlify dev **Flags** -- `command` (_option_) - command to run -- `port` (_option_) - port of netlify dev -- `targetPort` (_option_) - port of target app server -- `dir` (_option_) - dir with static files -- `functions` (_option_) - Specify a functions folder to serve -- `offline` (_boolean_) - disables any features that require network access -- `live` (_boolean_) - Start a public live session +- `command` (*option*) - command to run +- `port` (*option*) - port of netlify dev +- `targetPort` (*option*) - port of target app server +- `dir` (*option*) - dir with static files +- `functions` (*option*) - Specify a functions folder to serve +- `offline` (*boolean*) - disables any features that require network access +- `live` (*boolean*) - Start a public live session + +| Subcommand | description | +|:--------------------------- |:-----| +| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | -| Subcommand | description | -| :------------------------------------------ | :----------- | -| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | **Examples** @@ -39,12 +40,12 @@ $ netlify dev -c hugo ``` --- - ## `dev:exec` Exec command Runs a command within the netlify dev environment, e.g. with env variables from any installed addons + **Usage** ```bash diff --git a/docs/commands/functions.md b/docs/commands/functions.md index 536802f350c..c931da1509c 100644 --- a/docs/commands/functions.md +++ b/docs/commands/functions.md @@ -6,21 +6,22 @@ description: Run netlify dev locally # `functions` - Manage netlify functions The `functions` command will help you manage the functions in this site + **Usage** ```bash netlify functions ``` -| Subcommand | description | -| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | -| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | -| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | -| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | +| Subcommand | description | +|:--------------------------- |:-----| +| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | +| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | +| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | + **Examples** @@ -30,11 +31,11 @@ netlify functions:build --name function-abc --timeout 30s ``` --- - ## `functions:build` Build functions locally + **Usage** ```bash @@ -43,11 +44,10 @@ netlify functions:build **Flags** -- `functions` (_option_) - Specify a functions folder to build to -- `src` (_option_) - Specify the source folder for the functions +- `functions` (*option*) - Specify a functions folder to build to +- `src` (*option*) - Specify the source folder for the functions --- - ## `functions:create` Create a new function locally @@ -64,8 +64,8 @@ netlify functions:create **Flags** -- `name` (_option_) - function name -- `url` (_option_) - pull template from URL +- `name` (*option*) - function name +- `url` (*option*) - pull template from URL **Examples** @@ -76,7 +76,6 @@ netlify functions:create --name hello-world ``` --- - ## `functions:invoke` Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions @@ -93,11 +92,12 @@ netlify functions:invoke **Flags** -- `name` (_option_) - function name to invoke -- `functions` (_option_) - Specify a functions folder to parse, overriding netlify.toml -- `querystring` (_option_) - Querystring to add to your function invocation -- `payload` (_option_) - Supply POST payload in stringified json, or a path to a json file -- `identity` (_boolean_) - simulate Netlify Identity authentication JWT. pass --no-identity to affirm unauthenticated request +- `name` (*option*) - function name to invoke +- `functions` (*option*) - Specify a functions folder to parse, overriding netlify.toml +- `querystring` (*option*) - Querystring to add to your function invocation +- `payload` (*option*) - Supply POST payload in stringified json, or a path to a json file +- `identity` (*boolean*) - simulate Netlify Identity authentication JWT. pass --no-identity to affirm unauthenticated request +- `port` (*option*) - Port where netlify dev is accessible. e.g. 8888 **Examples** diff --git a/docs/commands/index.md b/docs/commands/index.md index c4630c65298..363c25f9bed 100644 --- a/docs/commands/index.md +++ b/docs/commands/index.md @@ -20,18 +20,18 @@ netlify [command] help ## Commands - ### [addons](/docs/commands/addons.md) (Beta) Manage Netlify Add-ons -| Subcommand | description | -| :------------------------------------------------------- | :---------------------------------------- | -| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | -| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | -| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | -| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | -| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`addons:auth`](/docs/commands/addons.md#addonsauth) | Login to add-on provider | +| [`addons:config`](/docs/commands/addons.md#addonsconfig) | Configure add-on settings | +| [`addons:create`](/docs/commands/addons.md#addonscreate) | Add an add-on extension to your site | +| [`addons:delete`](/docs/commands/addons.md#addonsdelete) | Remove an add-on extension to your site | +| [`addons:list`](/docs/commands/addons.md#addonslist) | List currently installed add-ons for site | + ### [api](/docs/commands/api.md) @@ -49,19 +49,21 @@ Create a new deploy from the contents of a folder Local dev server -| Subcommand | description | -| :------------------------------------------ | :----------- | -| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | +| Subcommand | description | +|:--------------------------- |:-----| +| [`dev:exec`](/docs/commands/dev.md#devexec) | Exec command | + ### [functions](/docs/commands/functions.md) Manage netlify functions -| Subcommand | description | -| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | -| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | -| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | -| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | +| Subcommand | description | +|:--------------------------- |:-----| +| [`functions:build`](/docs/commands/functions.md#functionsbuild) | Build functions locally | +| [`functions:create`](/docs/commands/functions.md#functionscreate) | Create a new function locally | +| [`functions:invoke`](/docs/commands/functions.md#functionsinvoke) | Trigger a function while in netlify dev with simulated data, good for testing function calls including Netlify's Event Triggered Functions | + ### [init](/docs/commands/init.md) @@ -79,28 +81,31 @@ Login to your Netlify account Open settings for the site linked to the current folder -| Subcommand | description | -| :----------------------------------------------- | :------------------------------------- | -| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | -| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | +| Subcommand | description | +|:--------------------------- |:-----| +| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | +| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | + ### [sites](/docs/commands/sites.md) Handle various site operations -| Subcommand | description | -| :---------------------------------------------------- | :-------------------------------- | -| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | -| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | -| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | +| Subcommand | description | +|:--------------------------- |:-----| +| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | +| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | +| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | + ### [status](/docs/commands/status.md) Print status information -| Subcommand | description | -| :----------------------------------------------------- | :---------------------------------------- | -| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | + ### [switch](/docs/commands/switch.md) @@ -114,4 +119,5 @@ Unlink a local folder from a Netlify site Watch for site deploy to finish + diff --git a/docs/commands/init.md b/docs/commands/init.md index 7f9b833f8c8..583fff8e3c9 100644 --- a/docs/commands/init.md +++ b/docs/commands/init.md @@ -6,7 +6,6 @@ description: Initialize a new site locally # `init` - Configure continuous deployment for a new or existing site **Usage** @@ -17,9 +16,10 @@ netlify init **Flags** -- `manual` (_boolean_) - Manually configure a git remote for CI -- `watch` (_boolean_) - Make the CLI wait for the first deploy to complete after setting up CI -- `force` (_boolean_) - Reinitialize CI hooks if the linked site is already configured to use CI -- `gitRemoteName` (_option_) - Name of Git remote to use. e.g. "origin" +- `manual` (*boolean*) - Manually configure a git remote for CI +- `watch` (*boolean*) - Make the CLI wait for the first deploy to complete after setting up CI +- `force` (*boolean*) - Reinitialize CI hooks if the linked site is already configured to use CI +- `gitRemoteName` (*option*) - Name of Git remote to use. e.g. "origin" + diff --git a/docs/commands/link.md b/docs/commands/link.md index 66ed48b605e..6d624386842 100644 --- a/docs/commands/link.md +++ b/docs/commands/link.md @@ -6,7 +6,6 @@ description: Link an existing site to a local site directory # `link` - Link a local repo or project folder to an existing site on Netlify **Usage** @@ -17,9 +16,9 @@ netlify link **Flags** -- `id` (_option_) - ID of site to link to -- `name` (_option_) - Name of site to link to -- `gitRemoteName` (_option_) - Name of Git remote to use. e.g. "origin" +- `id` (*option*) - ID of site to link to +- `name` (*option*) - Name of site to link to +- `gitRemoteName` (*option*) - Name of Git remote to use. e.g. "origin" **Examples** @@ -29,4 +28,5 @@ netlify link --id 123-123-123-123 netlify link --name my-site-name ``` + diff --git a/docs/commands/login.md b/docs/commands/login.md index 93b7922c058..e1e37a8cd0b 100644 --- a/docs/commands/login.md +++ b/docs/commands/login.md @@ -6,11 +6,11 @@ description: Login to your Netlify account # `login` - Login to your Netlify account Opens a web browser to acquire an OAuth token. + **Usage** ```bash @@ -19,6 +19,7 @@ netlify login **Flags** -- `new` (_boolean_) - Login to new Netlify account +- `new` (*boolean*) - Login to new Netlify account + diff --git a/docs/commands/logout.md b/docs/commands/logout.md index a8e2eecbd5d..582f650b4d3 100644 --- a/docs/commands/logout.md +++ b/docs/commands/logout.md @@ -7,7 +7,6 @@ hidden: true # `logout` - Logout of your Netlify account **Usage** @@ -15,5 +14,4 @@ Logout of your Netlify account ```bash netlify logout ``` - diff --git a/docs/commands/open.md b/docs/commands/open.md index e0e2f7cb763..0217326801f 100644 --- a/docs/commands/open.md +++ b/docs/commands/open.md @@ -5,7 +5,6 @@ title: Netlify CLI open command # `open` - Open settings for the site linked to the current folder **Usage** @@ -16,13 +15,14 @@ netlify open **Flags** -- `site` (_boolean_) - Open site -- `admin` (_boolean_) - Open Netlify site +- `site` (*boolean*) - Open site +- `admin` (*boolean*) - Open Netlify site + +| Subcommand | description | +|:--------------------------- |:-----| +| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | +| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | -| Subcommand | description | -| :----------------------------------------------- | :------------------------------------- | -| [`open:admin`](/docs/commands/open.md#openadmin) | Opens current site admin UI in Netlify | -| [`open:site`](/docs/commands/open.md#opensite) | Opens current site url in browser | **Examples** @@ -34,7 +34,6 @@ netlify open:site ``` --- - ## `open:admin` Opens current site admin UI in Netlify @@ -52,7 +51,6 @@ netlify open:admin ``` --- - ## `open:site` Opens current site url in browser diff --git a/docs/commands/sites.md b/docs/commands/sites.md index 0c7dde6e023..c855e7ce635 100644 --- a/docs/commands/sites.md +++ b/docs/commands/sites.md @@ -6,21 +6,22 @@ description: Manage Netlify sites via the command line # `sites` - Handle various site operations The sites command will help you manage all your sites + **Usage** ```bash netlify sites ``` -| Subcommand | description | -| :---------------------------------------------------- | :-------------------------------- | -| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | -| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | -| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | +| Subcommand | description | +|:--------------------------- |:-----| +| [`sites:create`](/docs/commands/sites.md#sitescreate) | Create an empty site (advanced) | +| [`sites:delete`](/docs/commands/sites.md#sitesdelete) | Delete a site | +| [`sites:list`](/docs/commands/sites.md#siteslist) | List all sites you have access to | + **Examples** @@ -30,12 +31,12 @@ netlify sites:list ``` --- - ## `sites:create` Create an empty site (advanced) -Create a blank site that isn't associated with any git remote. Does not link to the current working directory. +Create a blank site that isn't associated with any git remote. Does not link to the current working directory. + **Usage** @@ -45,19 +46,19 @@ netlify sites:create **Flags** -- `name` (_option_) - name of site -- `account-slug` (_option_) - account slug to create the site under -- `with-ci` (_boolean_) - initialize CI hooks during site creation -- `manual` (_boolean_) - Force manual CI setup. Used --with-ci flag +- `name` (*option*) - name of site +- `account-slug` (*option*) - account slug to create the site under +- `with-ci` (*boolean*) - initialize CI hooks during site creation +- `manual` (*boolean*) - Force manual CI setup. Used --with-ci flag --- - ## `sites:delete` Delete a site This command will permanently delete the site on Netlify. Use with caution. + **Usage** ```bash @@ -70,7 +71,7 @@ netlify sites:delete {site-id} **Flags** -- `force` (_boolean_) - delete without prompting (useful for CI) +- `force` (*boolean*) - delete without prompting (useful for CI) **Examples** @@ -79,7 +80,6 @@ netlify site:delete 1234-3262-1211 ``` --- - ## `sites:list` List all sites you have access to @@ -92,7 +92,7 @@ netlify sites:list **Flags** -- `json` (_boolean_) - Output site data as JSON +- `json` (*boolean*) - Output site data as JSON --- diff --git a/docs/commands/status.md b/docs/commands/status.md index 6c6a6144f0f..e3aa724fcd9 100644 --- a/docs/commands/status.md +++ b/docs/commands/status.md @@ -6,7 +6,6 @@ description: Get the current context of the netlify CLI # `status` - Print status information **Usage** @@ -17,14 +16,14 @@ netlify status **Flags** -- `verbose` (_boolean_) - Output system info +- `verbose` (*boolean*) - Output system info -| Subcommand | description | -| :----------------------------------------------------- | :---------------------------------------- | -| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | +| Subcommand | description | +|:--------------------------- |:-----| +| [`status:hooks`](/docs/commands/status.md#statushooks) | Print hook information of the linked site | ---- +--- ## `status:hooks` Print hook information of the linked site diff --git a/docs/commands/unlink.md b/docs/commands/unlink.md index 0777512686c..ee7a2818907 100644 --- a/docs/commands/unlink.md +++ b/docs/commands/unlink.md @@ -6,7 +6,6 @@ description: Link an existing site to a local site directory # `unlink` - Unlink a local folder from a Netlify site **Usage** @@ -15,4 +14,5 @@ Unlink a local folder from a Netlify site netlify unlink ``` + diff --git a/docs/commands/watch.md b/docs/commands/watch.md index 014dedb4c4e..2a6bbaa544b 100644 --- a/docs/commands/watch.md +++ b/docs/commands/watch.md @@ -6,7 +6,6 @@ hidden: true # `watch` - Watch for site deploy to finish **Usage** @@ -22,4 +21,5 @@ netlify watch git push && netlify watch ``` + diff --git a/package-lock.json b/package-lock.json index fb12f0fcc25..632bb1cba4e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "netlify-cli", - "version": "2.48.0", + "version": "2.49.0", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/package.json b/package.json index 9688816822e..ea69ac5f644 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "netlify-cli", "description": "Netlify command line tool", - "version": "2.48.0", + "version": "2.49.0", "author": "Netlify Inc.", "contributors": [ "Mathias Biilmann (https://twitter.com/biilmann)",