Skip to content

Commit 49614e2

Browse files
Deploying to gh-pages from @ dstackai/dstack@f174dff 🚀
1 parent c43a89f commit 49614e2

File tree

10 files changed

+236
-176
lines changed

10 files changed

+236
-176
lines changed

assets/images/social/examples.png

-338 Bytes
Loading

assets/images/social/partners.png

-427 Bytes
Loading

docs/guides/troubleshooting/index.html

Lines changed: 50 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1239,6 +1239,19 @@
12391239
<nav class="md-nav" aria-label="Typical issues">
12401240
<ul class="md-nav__list">
12411241

1242+
<li class="md-nav__item">
1243+
<a href="#no-fleets" class="md-nav__link">
1244+
<span class="md-ellipsis">
1245+
1246+
<span class="md-typeset">
1247+
No fleets
1248+
</span>
1249+
1250+
</span>
1251+
</a>
1252+
1253+
</li>
1254+
12421255
<li class="md-nav__item">
12431256
<a href="#no-offers" class="md-nav__link">
12441257
<span class="md-ellipsis">
@@ -4015,6 +4028,19 @@
40154028
<nav class="md-nav" aria-label="Typical issues">
40164029
<ul class="md-nav__list">
40174030

4031+
<li class="md-nav__item">
4032+
<a href="#no-fleets" class="md-nav__link">
4033+
<span class="md-ellipsis">
4034+
4035+
<span class="md-typeset">
4036+
No fleets
4037+
</span>
4038+
4039+
</span>
4040+
</a>
4041+
4042+
</li>
4043+
40184044
<li class="md-nav__item">
40194045
<a href="#no-offers" class="md-nav__link">
40204046
<span class="md-ellipsis">
@@ -4227,22 +4253,36 @@ <h4 id="cli-logs">CLI logs<a class="headerlink" href="#cli-logs" title="Permanen
42274253
and <a href="https://github.com/dstackai/dstack/issues/1551">this</a>.</p>
42284254
</blockquote>
42294255
<h2 id="typical-issues">Typical issues<a class="headerlink" href="#typical-issues" title="Permanent link">&para;</a></h2>
4256+
<h3 id="no-fleets">No fleets<a class="headerlink" href="#no-fleets" title="Permanent link">&para;</a></h3>
4257+
<p>If you run <code>dstack apply</code> and see <code>No fleets</code> status it can mean two things:</p>
4258+
<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="the-project-has-no-fleets" name="__tabbed_1" type="radio" /><input id="no-matching-fleet-found" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="the-project-has-no-fleets">The project has no fleets</label><label for="no-matching-fleet-found">No matching fleet found</label></div>
4259+
<div class="tabbed-content">
4260+
<div class="tabbed-block">
4261+
<p>In this case, ensure you've created one before submitting runs. This can be either a <a href="../../concepts/fleets/#backend-fleets">backend fleet</a> (if you are using cloud or Kubernetes) or an <a href="../../concepts/fleets/#ssh-fleets">SSH fleet</a> (if you're using on-prem clusters).</p>
4262+
<div class="admonition info">
4263+
<p class="admonition-title">Backend fleets</p>
4264+
<p>Note that creating <a href="../../concepts/fleets/#backend-fleets">backend fleet</a> doesn't necessarily require provisioning instances upfront. If you set <code>nodes</code> to a range, <code>dstack</code> will be able to provision instances as required. See <a href="../../concepts/fleets/#backend-fleets">backend fleet</a> for examples.</p>
4265+
</div>
4266+
</div>
4267+
<div class="tabbed-block">
4268+
<p>This means fleets exist but run requirements do not match the configuration of the fleet. Review your fleets, and ensure that both run and fleet configuration are correct.</p>
4269+
</div>
4270+
</div>
4271+
</div>
42304272
<h3 id="no-offers">No offers<a class="headerlink" href="#no-offers" title="Permanent link">&para;</a></h3>
42314273
<p>If you run <code>dstack apply</code> and don't see any instance offers, it means that
42324274
<code>dstack</code> could not find instances that match the requirements in your configuration.
42334275
Below are some of the reasons why this might happen.</p>
42344276
<blockquote>
42354277
<p>Feel free to use <code>dstack offer</code> to view available offers.</p>
42364278
</blockquote>
4237-
<h4 id="cause-1-no-fleets">Cause 1: No fleets<a class="headerlink" href="#cause-1-no-fleets" title="Permanent link">&para;</a></h4>
4238-
<p>Make sure you've created a <a href="../../concepts/fleets/">fleet</a> before submitting any runs.</p>
4239-
<h4 id="cause-2-no-backends">Cause 2: No backends<a class="headerlink" href="#cause-2-no-backends" title="Permanent link">&para;</a></h4>
4279+
<h4 id="cause-1-no-backends">Cause 1: No backends<a class="headerlink" href="#cause-1-no-backends" title="Permanent link">&para;</a></h4>
42404280
<p>If you are not using <a href="../../concepts/fleets/#ssh-fleets">SSH fleets</a>, make sure you have configured at least one <a href="../../concepts/backends/">backends</a>.</p>
42414281
<p>If you have configured a backend but still cannot use it, check the output of <code>dstack server</code> for backend configuration errors.</p>
42424282
<blockquote>
42434283
<p>You can find a list of successfully configured backends on the <a href="../../concepts/projects/#backends">project settings page</a> in the UI.</p>
42444284
</blockquote>
4245-
<h4 id="cause-3-requirements-mismatch">Cause 3: Requirements mismatch<a class="headerlink" href="#cause-3-requirements-mismatch" title="Permanent link">&para;</a></h4>
4285+
<h4 id="cause-2-requirements-mismatch">Cause 2: Requirements mismatch<a class="headerlink" href="#cause-2-requirements-mismatch" title="Permanent link">&para;</a></h4>
42464286
<p>When you apply a configuration, <code>dstack</code> tries to find instances that match the
42474287
<a href="../../reference/dstack.yml/task/#resources"><code>resources</code></a>,
42484288
<a href="../../reference/dstack.yml/task/#backends"><code>backends</code></a>,
@@ -4256,19 +4296,19 @@ <h4 id="cause-3-requirements-mismatch">Cause 3: Requirements mismatch<a class="h
42564296
Make sure your configuration doesn't set any conflicting requirements, such as
42574297
<code>regions</code> that don't exist in the specified <code>backends</code>, or <code>instance_types</code> that
42584298
don't match the specified <code>resources</code>.</p>
4259-
<h4 id="cause-4-too-specific-resources">Cause 4: Too specific resources<a class="headerlink" href="#cause-4-too-specific-resources" title="Permanent link">&para;</a></h4>
4299+
<h4 id="cause-3-too-specific-resources">Cause 3: Too specific resources<a class="headerlink" href="#cause-3-too-specific-resources" title="Permanent link">&para;</a></h4>
42604300
<p>If you set a resource requirement to an exact value, <code>dstack</code> will only select instances
42614301
that have exactly that amount of resources. For example, <code>cpu: 5</code> and <code>memory: 10GB</code> will only
42624302
match instances that have exactly 5 CPUs and exactly 10GB of memory.</p>
42634303
<p>Typically, you will want to set resource ranges to match more instances.
42644304
For example, <code>cpu: 4..8</code> and <code>memory: 10GB..</code> will match instances with 4 to 8 CPUs
42654305
and at least 10GB of memory.</p>
4266-
<h4 id="cause-5-default-resources">Cause 5: Default resources<a class="headerlink" href="#cause-5-default-resources" title="Permanent link">&para;</a></h4>
4306+
<h4 id="cause-4-default-resources">Cause 4: Default resources<a class="headerlink" href="#cause-4-default-resources" title="Permanent link">&para;</a></h4>
42674307
<p>By default, <code>dstack</code> uses these resource requirements:
42684308
<code>cpu: 2..</code>, <code>memory: 8GB..</code>, <code>disk: 100GB..</code>.
42694309
If you want to use smaller instances, override the <code>cpu</code>, <code>memory</code>, or <code>disk</code>
42704310
properties in your configuration.</p>
4271-
<h4 id="cause-6-gpu-requirements">Cause 6: GPU requirements<a class="headerlink" href="#cause-6-gpu-requirements" title="Permanent link">&para;</a></h4>
4311+
<h4 id="cause-5-gpu-requirements">Cause 5: GPU requirements<a class="headerlink" href="#cause-5-gpu-requirements" title="Permanent link">&para;</a></h4>
42724312
<p>By default, <code>dstack</code> only selects instances with no GPUs or a single NVIDIA GPU.
42734313
If you want to use non-NVIDIA GPUs or multi-GPU instances, set the <code>gpu</code> property
42744314
in your configuration.</p>
@@ -4277,11 +4317,11 @@ <h4 id="cause-6-gpu-requirements">Cause 6: GPU requirements<a class="headerlink"
42774317
<blockquote>
42784318
<p>If you don't specify the number of GPUs, <code>dstack</code> will only select single-GPU instances.</p>
42794319
</blockquote>
4280-
<h4 id="cause-7-network-volumes">Cause 7: Network volumes<a class="headerlink" href="#cause-7-network-volumes" title="Permanent link">&para;</a></h4>
4320+
<h4 id="cause-6-network-volumes">Cause 6: Network volumes<a class="headerlink" href="#cause-6-network-volumes" title="Permanent link">&para;</a></h4>
42814321
<p>If your run configuration uses <a href="../../concepts/volumes/#network-volumes">network volumes</a>,
42824322
<code>dstack</code> will only select instances from the same backend and region as the volumes.
42834323
For AWS, the availability zone of the volume and the instance should also match.</p>
4284-
<h4 id="cause-8-feature-support">Cause 8: Feature support<a class="headerlink" href="#cause-8-feature-support" title="Permanent link">&para;</a></h4>
4324+
<h4 id="cause-7-feature-support">Cause 7: Feature support<a class="headerlink" href="#cause-7-feature-support" title="Permanent link">&para;</a></h4>
42854325
<p>Some <code>dstack</code> features are not supported by all backends. If your configuration uses
42864326
one of these features, <code>dstack</code> will only select offers from the backends that support it.</p>
42874327
<ul>
@@ -4296,7 +4336,7 @@ <h4 id="cause-8-feature-support">Cause 8: Feature support<a class="headerlink" h
42964336
<li><a href="../../reference/dstack.yml/fleet/#reservation">Reservations</a>
42974337
are only supported by the <code>aws</code> and <code>gcp</code> backends.</li>
42984338
</ul>
4299-
<h4 id="cause-9-dstack-sky-balance">Cause 9: dstack Sky balance<a class="headerlink" href="#cause-9-dstack-sky-balance" title="Permanent link">&para;</a></h4>
4339+
<h4 id="cause-8-dstack-sky-balance">Cause 8: dstack Sky balance<a class="headerlink" href="#cause-8-dstack-sky-balance" title="Permanent link">&para;</a></h4>
43004340
<p>If you are using
43014341
<a href="https://sky.dstack.ai">dstack Sky</a>,
43024342
you will not see marketplace offers until you top up your balance.

docs/guides/troubleshooting/index.md

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,20 @@ and [this](https://github.com/dstackai/dstack/issues/1551).
2828

2929
## Typical issues
3030

31+
### No fleets { #no-fleets }
32+
[//]: # (NOTE: This section is referenced in the CLI. Do not change its URL.)
33+
34+
If you run `dstack apply` and see `No fleets` status it can mean two things:
35+
36+
=== "The project has no fleets"
37+
In this case, ensure you've created one before submitting runs. This can be either a [backend fleet](../concepts/fleets.md#backend-fleets) (if you are using cloud or Kubernetes) or an [SSH fleet](../concepts/fleets.md#ssh-fleets) (if you're using on-prem clusters).
38+
39+
!!! info "Backend fleets"
40+
Note that creating [backend fleet](../concepts/fleets.md#backend-fleets) doesn't necessarily require provisioning instances upfront. If you set `nodes` to a range, `dstack` will be able to provision instances as required. See [backend fleet](../concepts/fleets.md#backend-fleets) for examples.
41+
42+
=== "No matching fleet found"
43+
This means fleets exist but run requirements do not match the configuration of the fleet. Review your fleets, and ensure that both run and fleet configuration are correct.
44+
3145
### No offers { #no-offers }
3246
[//]: # (NOTE: This section is referenced in the CLI. Do not change its URL.)
3347

@@ -37,19 +51,15 @@ Below are some of the reasons why this might happen.
3751

3852
> Feel free to use `dstack offer` to view available offers.
3953
40-
#### Cause 1: No fleets
41-
42-
Make sure you've created a [fleet](../concepts/fleets.md) before submitting any runs.
43-
44-
#### Cause 2: No backends
54+
#### Cause 1: No backends
4555

4656
If you are not using [SSH fleets](../concepts/fleets.md#ssh-fleets), make sure you have configured at least one [backends](../concepts/backends.md).
4757

4858
If you have configured a backend but still cannot use it, check the output of `dstack server` for backend configuration errors.
4959

5060
> You can find a list of successfully configured backends on the [project settings page](../concepts/projects.md#backends) in the UI.
5161
52-
#### Cause 3: Requirements mismatch
62+
#### Cause 2: Requirements mismatch
5363

5464
When you apply a configuration, `dstack` tries to find instances that match the
5565
[`resources`](../reference/dstack.yml/task.md#resources),
@@ -66,7 +76,7 @@ Make sure your configuration doesn't set any conflicting requirements, such as
6676
`regions` that don't exist in the specified `backends`, or `instance_types` that
6777
don't match the specified `resources`.
6878

69-
#### Cause 4: Too specific resources
79+
#### Cause 3: Too specific resources
7080

7181
If you set a resource requirement to an exact value, `dstack` will only select instances
7282
that have exactly that amount of resources. For example, `cpu: 5` and `memory: 10GB` will only
@@ -76,14 +86,14 @@ Typically, you will want to set resource ranges to match more instances.
7686
For example, `cpu: 4..8` and `memory: 10GB..` will match instances with 4 to 8 CPUs
7787
and at least 10GB of memory.
7888

79-
#### Cause 5: Default resources
89+
#### Cause 4: Default resources
8090

8191
By default, `dstack` uses these resource requirements:
8292
`cpu: 2..`, `memory: 8GB..`, `disk: 100GB..`.
8393
If you want to use smaller instances, override the `cpu`, `memory`, or `disk`
8494
properties in your configuration.
8595

86-
#### Cause 6: GPU requirements
96+
#### Cause 5: GPU requirements
8797

8898
By default, `dstack` only selects instances with no GPUs or a single NVIDIA GPU.
8999
If you want to use non-NVIDIA GPUs or multi-GPU instances, set the `gpu` property
@@ -94,13 +104,13 @@ Examples: `gpu: amd` (one AMD GPU), `gpu: A10:4..8` (4 to 8 A10 GPUs),
94104

95105
> If you don't specify the number of GPUs, `dstack` will only select single-GPU instances.
96106
97-
#### Cause 7: Network volumes
107+
#### Cause 6: Network volumes
98108

99109
If your run configuration uses [network volumes](../concepts/volumes.md#network-volumes),
100110
`dstack` will only select instances from the same backend and region as the volumes.
101111
For AWS, the availability zone of the volume and the instance should also match.
102112

103-
#### Cause 8: Feature support
113+
#### Cause 7: Feature support
104114

105115
Some `dstack` features are not supported by all backends. If your configuration uses
106116
one of these features, `dstack` will only select offers from the backends that support it.
@@ -116,7 +126,7 @@ one of these features, `dstack` will only select offers from the backends that s
116126
- [Reservations](../reference/dstack.yml/fleet.md#reservation)
117127
are only supported by the `aws` and `gcp` backends.
118128

119-
#### Cause 9: dstack Sky balance
129+
#### Cause 8: dstack Sky balance
120130

121131
If you are using
122132
[dstack Sky](https://sky.dstack.ai),

docs/reference/api/rest/openapi.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)