Skip to content

Commit a99ee19

Browse files
Swatinembitsandfoxes
authored andcommitted
Remove docs related to the deprecated sentry-cli files commands (#13767)
Going forward, we only want to support uploading sourcemaps via the `sentry-cli sourcemaps upload` command. This removes docs related to the deprecated `files upload` command, so it is less discoverable.
1 parent a70f432 commit a99ee19

File tree

4 files changed

+5
-44
lines changed

4 files changed

+5
-44
lines changed

docs/cli/releases.mdx

Lines changed: 2 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -116,29 +116,9 @@ which is creating a release with a specified number of commits (see the section
116116
sentry-cli releases set-commits "$VERSION" --auto --ignore-missing
117117
```
118118

119-
## Managing Release Artifacts
119+
## Upload Source Maps
120120

121-
When you are working with JavaScript and other platforms, you can upload release artifacts to Sentry which are then considered during processing. The most common release artifact are [source maps](/platforms/javascript/sourcemaps/) for which `sentry-cli` has specific support.
122-
123-
To manage release artifacts the `sentry-cli files` command can be used which itself provides various sub commands.
124-
125-
### Upload Files
126-
127-
The most common use case is to upload files. For the generic upload the `sentry-cli files upload` command can be used. However since most release artifacts are JavaScript source map related we have a [Upload Source Maps](#sentry-cli-sourcemaps) convenience method for that.
128-
129-
Files uploaded are typically named with a full (eg: `http://example.com/foo.js`) or truncated URL (eg: `~/foo.js`).
130-
131-
Release artifacts are only considered at time of event processing. So while it’s possible to modify release artifacts after the fact they will only be considered for future events of that release.
132-
133-
The first argument to `upload` is the path to the file, the second is an optional URL we should associate it with. Note that if you want to use an abbreviated URL (eg: `~/foo.js`) make sure to use single quotes to avoid the expansion by the shell to your home folder.
134-
135-
```bash
136-
sentry-cli files upload --release "$VERSION" /path/to/file '~/file.js'
137-
```
138-
139-
### Upload Source Maps
140-
141-
For source map upload, a separate command is provided which assists you in uploading and verifying source maps:
121+
You can upload sourcemaps via the `sentry-cli sourcemaps upload` command:
142122

143123
```bash
144124
sentry-cli sourcemaps upload /path/to/sourcemaps
@@ -212,25 +192,6 @@ sentry-cli sourcemaps upload /path/to/sourcemaps --url-prefix '~/static/js' \
212192
sentry-cli sourcemaps upload /path/to/sourcemaps --ignore-file .sentryignore
213193
```
214194

215-
### List Files
216-
217-
To list uploaded files, the following command can be used:
218-
219-
```bash
220-
sentry-cli files list --release "$VERSION"
221-
```
222-
223-
This will return a list of all uploaded files for that release.
224-
225-
### Delete Files
226-
227-
You can also delete already uploaded files. Either by name or all files at once:
228-
229-
```bash
230-
sentry-cli files delete --release "$VERSION" NAME_OF_FILE
231-
sentry-cli files delete --release "$VERSION" --all
232-
```
233-
234195
## Creating Deploys
235196

236197
You can also associate deploys with releases. To create a deploy you first create a release and then a deploy for it. At the very least, you should supply the “environment” the deploy goes to (production, staging etc.). You can freely define this:

platform-includes/sourcemaps/legacy-troubleshooting/javascript.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,7 @@ If you have the same (incorrect) results locally as you do via Sentry, double-ch
225225

226226
The Sentry API currently only works with source maps and source files that are uploaded as plain text (UTF-8 encoded). If the files are uploaded in a compressed format (for example, gzip), they will be not be interpreted correctly.
227227

228-
If you are using `sentry-cli` to upload your artifacts, starting with version `2.4.0` you can add the `--decompress` flag to your `sourcemaps upload` or `files upload` commands.
228+
If you are using `sentry-cli` to upload your artifacts, starting with version `2.4.0` you can add the `--decompress` flag to your `sourcemaps upload` commands.
229229

230230
Sometimes build scripts and plugins produce pre-compressed minified files (for example, webpack's [compression plugin](https://github.com/webpack/compression-webpack-plugin)). In these cases, you'll need to disable such plugins and perform the compression **after** the generated source maps/source files have been uploaded to Sentry.
231231

platform-includes/sourcemaps/legacy-uploading-methods/javascript.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -498,7 +498,7 @@ If you have the same (incorrect) results locally as you do via Sentry, double-ch
498498

499499
The Sentry API currently only works with source maps and source files that are uploaded as plain text (UTF-8 encoded). If the files are uploaded in a compressed format (for example, gzip), they will be not be interpreted correctly.
500500

501-
If you are using `sentry-cli` to upload your artifacts, starting with version `2.4.0` you can add the `--decompress` flag to your `sourcemaps upload` or `files upload` commands.
501+
If you are using `sentry-cli` to upload your artifacts, starting with version `2.4.0` you can add the `--decompress` flag to your `sourcemaps upload` commands.
502502

503503
Sometimes build scripts and plugins produce pre-compressed minified files (for example, webpack's [compression plugin](https://github.com/webpack/compression-webpack-plugin)). In these cases, you'll need to disable such plugins and perform the compression **after** the generated source maps/source files have been uploaded to Sentry.
504504

platform-includes/sourcemaps/troubleshooting/javascript.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ If you have the same (incorrect) results locally as you do via Sentry, double-ch
141141

142142
The Sentry API currently only works with source maps and source files that are uploaded as plain text (UTF-8 encoded). If the files are uploaded in a compressed format (for example, gzip), they will be not be interpreted correctly.
143143

144-
If you are using `sentry-cli` to upload your artifacts, starting with version `2.4.0` you can add the `--decompress` flag to your `sourcemaps upload` or `files upload` commands.
144+
If you are using `sentry-cli` to upload your artifacts, starting with version `2.4.0` you can add the `--decompress` flag to your `sourcemaps upload` commands.
145145

146146
Sometimes build scripts and plugins produce pre-compressed minified files (for example, webpack's [compression plugin](https://github.com/webpack/compression-webpack-plugin)). In these cases, you'll need to disable such plugins and perform the compression **after** the generated source maps/source files have been uploaded to Sentry.
147147

0 commit comments

Comments
 (0)