Commit 3221144c authored by Junji Watanabe's avatar Junji Watanabe Committed by Chromium LUCI CQ

[docs] replace isolate server with CAS in debugging-with-swarming.md

CAS is already available on production, and developers should be able to use it instead of Isolate server.

Bug: 1163817
Change-Id: I1ea0333725eb8c6337507605781e9c3e29b4f5e3
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/2626816
Commit-Queue: Takuto Ikuta <tikuta@chromium.org>
Auto-Submit: Junji Watanabe <jwata@google.com>
Reviewed-by: default avatarTakuto Ikuta <tikuta@chromium.org>
Cr-Commit-Position: refs/heads/master@{#842913}
parent 2db848b9
...@@ -16,7 +16,7 @@ of [Borg], or to [Kubernetes]. ...@@ -16,7 +16,7 @@ of [Borg], or to [Kubernetes].
An *isolate* is an archive containing all the files needed to do a specific task An *isolate* is an archive containing all the files needed to do a specific task
on the swarming infrastructure. It contains binaries as well as any libraries on the swarming infrastructure. It contains binaries as well as any libraries
they link against or support data. An isolate can be thought of like a tarball, they link against or support data. An isolate can be thought of like a tarball,
but held by the "isolate server" and identified by a hash of its contents. The but held by the CAS server and identified by a digest of its contents. The
isolate also includes the command(s) to run, which is why the command is isolate also includes the command(s) to run, which is why the command is
specified when building the isolate, not when executing it. specified when building the isolate, not when executing it.
...@@ -50,7 +50,7 @@ want to do is: ...@@ -50,7 +50,7 @@ want to do is:
or perhaps: or perhaps:
``` ```
isolate = upload_to_isolate_server(target_you_built_locally) isolate = upload_to_cas(target_you_built_locally)
use_swarming_to_run(type, isolate) use_swarming_to_run(type, isolate)
``` ```
...@@ -167,19 +167,21 @@ Use your google.com account for this. ...@@ -167,19 +167,21 @@ Use your google.com account for this.
## Uploading an isolate ## Uploading an isolate
You can then upload the resulting isolate to the isolate server: You can then upload the resulting isolate to the CAS server:
``` ```
$ tools/luci-go/isolate archive \ $ tools/luci-go/isolate archive \
-I https://isolateserver.appspot.com \ -cas-instance chroimum-swarm \
-i $outdir/$target.isolate \ -i $outdir/$target.isolate \
-s $outdir/$target.isolated -dump-json $outdir/$target.archive.json
``` ```
The `isolate` tool will emit something like this: The archive json looks like this:
``` ```
e625130b712096e3908266252c8cd779d7f442f1 unit_tests {
"unit_tests": "5bee0815d2ddd2b876b49d4cce8aaa23de8a6f9e2dbf134ec409fbdc224e8c64/398"
}
``` ```
Do not ctrl-c it after it does this, even if it seems to be hanging for a Do not ctrl-c it after it does this, even if it seems to be hanging for a
...@@ -187,16 +189,15 @@ minute - just let it finish. ...@@ -187,16 +189,15 @@ minute - just let it finish.
## Running an isolate ## Running an isolate
Now that the isolate is on the isolate server with hash `$hash` from the Now that the isolate is on the CAS server with digest `$digest` from the
previous step, you can run on bots of your choice: previous step, you can run on bots of your choice:
``` ```
$ tools/luci-go/swarming trigger \ $ tools/luci-go/swarming trigger \
-server https://chromium-swarm.appspot.com \ -server https://chromium-swarm.appspot.com \
-isolate-server https://isolateserver.appspot.com \
-dimension pool=$pool \ -dimension pool=$pool \
$criteria \ $criteria \
-isolated $hash -digest $digest
``` ```
There are two more things you need to fill in here. The first is the pool name; There are two more things you need to fill in here. The first is the pool name;
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment