Skip to content

Changes in docs for release: v0.16.4 #571

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/detailed-documentation/cluster/awload.html
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ <h1 class="title">Module <code>codeflare_sdk.cluster.awload</code></h1>
class AWManager:
&#34;&#34;&#34;
An object for submitting and removing existing AppWrapper yamls
to be added to the MCAD queue.
to be added to the Kueue localqueue.
&#34;&#34;&#34;

def __init__(self, filename: str) -&gt; None:
Expand Down Expand Up @@ -145,7 +145,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
</code></dt>
<dd>
<div class="desc"><p>An object for submitting and removing existing AppWrapper yamls
to be added to the MCAD queue.</p>
to be added to the Kueue localqueue.</p>
<p>Create the AppWrapper Manager object by passing in an
AppWrapper yaml file</p></div>
<details class="source">
Expand All @@ -155,7 +155,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
<pre><code class="python">class AWManager:
&#34;&#34;&#34;
An object for submitting and removing existing AppWrapper yamls
to be added to the MCAD queue.
to be added to the Kueue localqueue.
&#34;&#34;&#34;

def __init__(self, filename: str) -&gt; None:
Expand Down
30 changes: 9 additions & 21 deletions docs/detailed-documentation/cluster/cluster.html
Original file line number Diff line number Diff line change
Expand Up @@ -179,11 +179,9 @@ <h1 class="title">Module <code>codeflare_sdk.cluster.cluster</code></h1>
template = self.config.template
image = self.config.image
appwrapper = self.config.appwrapper
instance_types = self.config.machine_types
env = self.config.envs
image_pull_secrets = self.config.image_pull_secrets
write_to_file = self.config.write_to_file
verify_tls = self.config.verify_tls
local_queue = self.config.local_queue
labels = self.config.labels
return generate_appwrapper(
Expand All @@ -201,20 +199,18 @@ <h1 class="title">Module <code>codeflare_sdk.cluster.cluster</code></h1>
template=template,
image=image,
appwrapper=appwrapper,
instance_types=instance_types,
env=env,
image_pull_secrets=image_pull_secrets,
write_to_file=write_to_file,
verify_tls=verify_tls,
local_queue=local_queue,
labels=labels,
)

# creates a new cluster with the provided or default spec
def up(self):
&#34;&#34;&#34;
Applies the AppWrapper yaml, pushing the resource request onto
the MCAD queue.
Applies the Cluster yaml, pushing the resource request onto
the Kueue localqueue.
&#34;&#34;&#34;

# check if RayCluster CustomResourceDefinition exists if not throw RuntimeError
Expand Down Expand Up @@ -1229,11 +1225,9 @@ <h2 class="section-title" id="header-classes">Classes</h2>
template = self.config.template
image = self.config.image
appwrapper = self.config.appwrapper
instance_types = self.config.machine_types
env = self.config.envs
image_pull_secrets = self.config.image_pull_secrets
write_to_file = self.config.write_to_file
verify_tls = self.config.verify_tls
local_queue = self.config.local_queue
labels = self.config.labels
return generate_appwrapper(
Expand All @@ -1251,20 +1245,18 @@ <h2 class="section-title" id="header-classes">Classes</h2>
template=template,
image=image,
appwrapper=appwrapper,
instance_types=instance_types,
env=env,
image_pull_secrets=image_pull_secrets,
write_to_file=write_to_file,
verify_tls=verify_tls,
local_queue=local_queue,
labels=labels,
)

# creates a new cluster with the provided or default spec
def up(self):
&#34;&#34;&#34;
Applies the AppWrapper yaml, pushing the resource request onto
the MCAD queue.
Applies the Cluster yaml, pushing the resource request onto
the Kueue localqueue.
&#34;&#34;&#34;

# check if RayCluster CustomResourceDefinition exists if not throw RuntimeError
Expand Down Expand Up @@ -1776,11 +1768,9 @@ <h3>Methods</h3>
template = self.config.template
image = self.config.image
appwrapper = self.config.appwrapper
instance_types = self.config.machine_types
env = self.config.envs
image_pull_secrets = self.config.image_pull_secrets
write_to_file = self.config.write_to_file
verify_tls = self.config.verify_tls
local_queue = self.config.local_queue
labels = self.config.labels
return generate_appwrapper(
Expand All @@ -1798,11 +1788,9 @@ <h3>Methods</h3>
template=template,
image=image,
appwrapper=appwrapper,
instance_types=instance_types,
env=env,
image_pull_secrets=image_pull_secrets,
write_to_file=write_to_file,
verify_tls=verify_tls,
local_queue=local_queue,
labels=labels,
)</code></pre>
Expand Down Expand Up @@ -1974,7 +1962,7 @@ <h3>Methods</h3>
</details>
</dd>
<dt id="codeflare_sdk.cluster.cluster.Cluster.list_jobs"><code class="name flex">
<span>def <span class="ident">list_jobs</span></span>(<span>self) ‑> List[~T]</span>
<span>def <span class="ident">list_jobs</span></span>(<span>self) ‑> List</span>
</code></dt>
<dd>
<div class="desc"><p>This method accesses the head ray node in your cluster and lists the running jobs.</p></div>
Expand Down Expand Up @@ -2090,16 +2078,16 @@ <h3>Methods</h3>
<span>def <span class="ident">up</span></span>(<span>self)</span>
</code></dt>
<dd>
<div class="desc"><p>Applies the AppWrapper yaml, pushing the resource request onto
the MCAD queue.</p></div>
<div class="desc"><p>Applies the Cluster yaml, pushing the resource request onto
the Kueue localqueue.</p></div>
<details class="source">
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">def up(self):
&#34;&#34;&#34;
Applies the AppWrapper yaml, pushing the resource request onto
the MCAD queue.
Applies the Cluster yaml, pushing the resource request onto
the Kueue localqueue.
&#34;&#34;&#34;

# check if RayCluster CustomResourceDefinition exists if not throw RuntimeError
Expand Down
3 changes: 2 additions & 1 deletion docs/detailed-documentation/cluster/config.html
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,8 @@ <h2 class="section-title" id="header-classes">Classes</h2>
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">class ClusterConfiguration:
<pre><code class="python">@dataclass
class ClusterConfiguration:
&#34;&#34;&#34;
This dataclass is used to specify resource requirements and other details, and
is passed in as an argument when creating a Cluster object.
Expand Down
6 changes: 4 additions & 2 deletions docs/detailed-documentation/cluster/model.html
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,8 @@ <h2 class="section-title" id="header-classes">Classes</h2>
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">class AppWrapper:
<pre><code class="python">@dataclass
class AppWrapper:
&#34;&#34;&#34;
For storing information about an AppWrapper.
&#34;&#34;&#34;
Expand Down Expand Up @@ -299,7 +300,8 @@ <h3>Class variables</h3>
<summary>
<span>Expand source code</span>
</summary>
<pre><code class="python">class RayCluster:
<pre><code class="python">@dataclass
class RayCluster:
&#34;&#34;&#34;
For storing information about a Ray cluster.
&#34;&#34;&#34;
Expand Down
4 changes: 2 additions & 2 deletions docs/detailed-documentation/job/ray_jobs.html
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
<dl>
<dt id="codeflare_sdk.job.ray_jobs.RayJobClient"><code class="flex name class">
<span>class <span class="ident">RayJobClient</span></span>
<span>(</span><span>address: Optional[str] = None, create_cluster_if_needed: bool = False, cookies: Optional[Dict[str, Any]] = None, metadata: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, Any]] = None, verify: Union[str, bool, None] = True)</span>
<span>(</span><span>address: Optional[str] = None, create_cluster_if_needed: bool = False, cookies: Optional[Dict[str, Any]] = None, metadata: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, Any]] = None, verify: Union[str, bool, ForwardRef(None)] = True)</span>
</code></dt>
<dd>
<div class="desc"><p>A class that functions as a wrapper for the Ray Job Submission Client.</p>
Expand Down Expand Up @@ -461,7 +461,7 @@ <h3>Methods</h3>
</details>
</dd>
<dt id="codeflare_sdk.job.ray_jobs.RayJobClient.submit_job"><code class="name flex">
<span>def <span class="ident">submit_job</span></span>(<span>self, entrypoint: str, job_id: Optional[str] = None, runtime_env: Optional[Dict[str, Any]] = None, metadata: Optional[Dict[str, str]] = None, submission_id: Optional[str] = None, entrypoint_num_cpus: Union[int, float, None] = None, entrypoint_num_gpus: Union[int, float, None] = None, entrypoint_resources: Optional[Dict[str, float]] = None) ‑> str</span>
<span>def <span class="ident">submit_job</span></span>(<span>self, entrypoint: str, job_id: Optional[str] = None, runtime_env: Optional[Dict[str, Any]] = None, metadata: Optional[Dict[str, str]] = None, submission_id: Optional[str] = None, entrypoint_num_cpus: Union[int, float, ForwardRef(None)] = None, entrypoint_num_gpus: Union[int, float, ForwardRef(None)] = None, entrypoint_resources: Optional[Dict[str, float]] = None) ‑> str</span>
</code></dt>
<dd>
<div class="desc"><p>Method for submitting jobs to a Ray Cluster and returning the job id with entrypoint being a mandatory field.</p>
Expand Down
Loading