Skip to content

Commit 2010c71

Browse files
committed
guide: roll-back unrelated changes to URLs in external data docs
1 parent 990de59 commit 2010c71

File tree

2 files changed

+35
-35
lines changed

2 files changed

+35
-35
lines changed

content/docs/user-guide/external-dependencies.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -45,40 +45,40 @@ stage to your list of stages in dvc.yaml.
4545

4646
```dvc
4747
$ dvc run -n download_file
48-
-d s3://mybucket/data \
49-
-o data \
50-
aws s3 cp s3://mybucket/data data
48+
-d s3://mybucket/data.txt \
49+
-o data.txt \
50+
aws s3 cp s3://mybucket/data.txt data.txt
5151
```
5252

5353
### Microsoft Azure Blob Storage
5454

5555
```dvc
5656
$ dvc run -n download_file
57-
-d azure://my-container-name/data \
58-
-o data \
57+
-d azure://my-container-name/data.txt \
58+
-o data.txt \
5959
az storage copy \
6060
-d data.json \
6161
--source-account-name my-account \
6262
--source-container my-container-name \
63-
--source-blob data
63+
--source-blob data.txt
6464
```
6565

6666
### Google Cloud Storage
6767

6868
```dvc
6969
$ dvc run -n download_file
70-
-d gs://mybucket/data \
71-
-o data \
72-
gsutil cp gs://mybucket/data data
70+
-d gs://mybucket/data.txt \
71+
-o data.txt \
72+
gsutil cp gs://mybucket/data.txt data.txt
7373
```
7474

7575
### SSH
7676

7777
```dvc
7878
$ dvc run -n download_file
79-
-d ssh://[email protected]/path/to/data \
80-
-o data \
81-
scp [email protected]:/path/to/data data
79+
-d ssh://[email protected]/path/to/data.txt \
80+
-o data.txt \
81+
scp [email protected]:/path/to/data.txt data.txt
8282
```
8383

8484
⚠️ DVC requires both SSH and SFTP access to work with remote SSH locations.
@@ -91,10 +91,10 @@ Please check that you are able to connect both ways with tools like `ssh` and
9191

9292
```dvc
9393
$ dvc run -n download_file
94-
-d hdfs://[email protected]/data \
95-
-o data \
94+
-d hdfs://[email protected]/data.txt \
95+
-o data.txt \
9696
hdfs fs -copyToLocal \
97-
hdfs://[email protected]/data data
97+
hdfs://[email protected]/data.txt data.txt
9898
```
9999

100100
### HTTP
@@ -103,18 +103,18 @@ $ dvc run -n download_file
103103
104104
```dvc
105105
$ dvc run -n download_file
106-
-d https://example.com/data \
107-
-o data \
108-
wget https://example.com/data -O data
106+
-d https://example.com/data.txt \
107+
-o data.txt \
108+
wget https://example.com/data.txt -O data.txt
109109
```
110110

111111
### Local file system path
112112

113113
```dvc
114114
$ dvc run -n download_file
115-
-d /home/shared/data \
116-
-o data \
117-
cp /home/shared/data data
115+
-d /home/shared/data.txt \
116+
-o data.txt \
117+
cp /home/shared/data.txt data.txt
118118
```
119119

120120
## Example: DVC remote aliases
@@ -130,9 +130,9 @@ For example, for an HTTPs remote/dependency:
130130
```dvc
131131
$ dvc remote add example https://example.com
132132
$ dvc run -n download_file
133-
-d remote://example/data \
134-
-o data \
135-
wget https://example.com/data -O data
133+
-d remote://example/data.txt \
134+
-o data.txt \
135+
wget https://example.com/data.txt -O data.txt
136136
```
137137

138138
Please refer to `dvc remote add` for more details like setting up access

content/docs/user-guide/managing-external-data.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ in the same external/remote file system first.
4343
## Examples
4444

4545
For the examples, let's take a look at a [stage](/doc/command-reference/run)
46-
that simply moves local file to an external location, producing a `data.dvc`
46+
that simply moves local file to an external location, producing a `data.txt.dvc`
4747
DVC-file.
4848

4949
### Amazon S3
@@ -61,8 +61,8 @@ $ dvc add --external s3://mybucket/mydata
6161
# Create the stage with an external S3 output
6262
$ dvc run -d data \
6363
--external \
64-
-o s3://mybucket/data \
65-
aws s3 cp data s3://mybucket/data
64+
-o s3://mybucket/data.txt \
65+
aws s3 cp data s3://mybucket/data.txt
6666
```
6767

6868
### Google Cloud Storage
@@ -80,8 +80,8 @@ $ dvc add --external gs://mybucket/mydata
8080
# Create the stage with an external GS output
8181
$ dvc run -d data \
8282
--external \
83-
-o gs://mybucket/data \
84-
gsutil cp data gs://mybucket/data
83+
-o gs://mybucket/data.txt \
84+
gsutil cp data gs://mybucket/data.txt
8585
```
8686

8787
### SSH
@@ -99,8 +99,8 @@ $ dvc add --external ssh://[email protected]/mydata
9999
# Create the stage with an external SSH output
100100
$ dvc run -d data \
101101
--external \
102-
-o ssh://[email protected]/data \
103-
scp data [email protected]:/data
102+
-o ssh://[email protected]/data.txt \
103+
scp data [email protected]:/data.txt
104104
```
105105

106106
⚠️ DVC requires both SSH and SFTP access to work with remote SSH locations.
@@ -125,10 +125,10 @@ $ dvc add --external hdfs://[email protected]/mydata
125125
# Create the stage with an external HDFS output
126126
$ dvc run -d data \
127127
--external \
128-
-o hdfs://[email protected]/data \
128+
-o hdfs://[email protected]/data.txt \
129129
hdfs fs -copyFromLocal \
130130
data \
131-
hdfs://[email protected]/data
131+
hdfs://[email protected]/data.txt
132132
```
133133

134134
Note that as long as there is a `hdfs://...` URL for your data, DVC can handle
@@ -146,6 +146,6 @@ $ dvc add --external /home/shared/mydata
146146
# Create the stage with an external location output
147147
$ dvc run -d data \
148148
--external \
149-
-o /home/shared/data \
150-
cp data /home/shared/data
149+
-o /home/shared/data.txt \
150+
cp data /home/shared/data.txt
151151
```

0 commit comments

Comments
 (0)