endpoint.rs 4.94 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

16
17
use std::sync::Arc;

Neelay Shah's avatar
Neelay Shah committed
18
use dynamo_llm::{
19
    backend::Backend,
20
    engines::StreamingEngineAdapter,
21
    http::service::discovery::ModelEntry,
22
23
    key_value_store::{KeyValueStore, KeyValueStoreManager, NATSStorage},
    model_card::{BUCKET_NAME, BUCKET_TTL},
24
    model_type::ModelType,
25
26
    preprocessor::OpenAIPreprocessor,
    types::{
27
28
29
        openai::chat_completions::{
            NvCreateChatCompletionRequest, NvCreateChatCompletionStreamResponse,
        },
30
31
        Annotated,
    },
32
};
Neelay Shah's avatar
Neelay Shah committed
33
use dynamo_runtime::pipeline::{
34
35
    network::Ingress, ManyOut, Operator, SegmentSource, ServiceBackend, SingleIn, Source,
};
36
use dynamo_runtime::{protocols::Endpoint, DistributedRuntime};
37

38
use crate::EngineConfig;
39
40

pub async fn run(
41
    distributed_runtime: DistributedRuntime,
42
43
44
45
46
    path: String,
    engine_config: EngineConfig,
) -> anyhow::Result<()> {
    // This will attempt to connect to NATS and etcd

47
    let cancel_token = distributed_runtime.primary_token().clone();
48
    let endpoint_id: Endpoint = path.parse()?;
49

50
51
    let etcd_client = distributed_runtime.etcd_client();

52
    let (ingress, service_name, mut card) = match engine_config {
53
54
55
        EngineConfig::StaticFull {
            service_name,
            engine,
56
            card,
57
58
59
60
        } => {
            let engine = Arc::new(StreamingEngineAdapter::new(engine));
            (Ingress::for_engine(engine)?, service_name, card)
        }
61
62
63
64
        EngineConfig::StaticCore {
            service_name,
            engine: inner_engine,
            card,
65
        } => {
66
            let frontend = SegmentSource::<
67
                SingleIn<NvCreateChatCompletionRequest>,
68
                ManyOut<Annotated<NvCreateChatCompletionStreamResponse>>,
69
70
71
72
73
74
            >::new();
            let preprocessor = OpenAIPreprocessor::new(*card.clone())
                .await?
                .into_operator();
            let backend = Backend::from_mdc(*card.clone()).await?.into_operator();
            let engine = ServiceBackend::from_engine(inner_engine);
75

76
77
78
79
80
81
82
            let pipeline = frontend
                .link(preprocessor.forward_edge())?
                .link(backend.forward_edge())?
                .link(engine)?
                .link(backend.backward_edge())?
                .link(preprocessor.backward_edge())?
                .link(frontend)?;
83

84
            (Ingress::for_pipeline(pipeline)?, service_name, card)
85
86
87
88
        }
        EngineConfig::Dynamic(_) => {
            anyhow::bail!("Cannot use endpoint for both in and out");
        }
89
        EngineConfig::None => unreachable!(),
90
91
92
93
    };

    let model_registration = ModelEntry {
        name: service_name.to_string(),
94
        endpoint: endpoint_id.clone(),
95
        model_type: ModelType::Chat,
96
    };
97

98
    let component = distributed_runtime
99
100
        .namespace(&endpoint_id.namespace)?
        .component(&endpoint_id.component)?;
101
102
103
104
    let endpoint = component
        .service_builder()
        .create()
        .await?
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
        .endpoint(&endpoint_id.name);

    let nats_client = distributed_runtime.nats_client();
    card.move_to_nats(nats_client.clone()).await?;

    let kvstore: Box<dyn KeyValueStore> =
        Box::new(NATSStorage::new(nats_client.clone(), endpoint_id));
    let card_store = Arc::new(KeyValueStoreManager::new(kvstore));
    card.requires_preprocessing = false;
    card_store.publish_until_cancelled(
        cancel_token.clone(),
        BUCKET_NAME.to_string(),
        Some(BUCKET_TTL),
        BUCKET_TTL / 2,
        card.slug().to_string(),
        *card.clone(),
    );
122

123
124
    if let Some(etcd_client) = etcd_client {
        let network_name = endpoint.subject_to(etcd_client.lease_id());
125
126
127
128
129
130
131
132
133
        tracing::debug!("Registering with etcd as {network_name}");
        etcd_client
            .kv_create(
                network_name.clone(),
                serde_json::to_vec_pretty(&model_registration)?,
                Some(etcd_client.lease_id()),
            )
            .await?;
    }
134

135
    let rt_fut = endpoint.endpoint_builder().handler(ingress).start();
136
137
138
139
140
141
    tokio::select! {
        _ = rt_fut => {
            tracing::debug!("Endpoint ingress ended");
        }
        _ = cancel_token.cancelled() => {
        }
142
    }
143
144
145
146
    // Cleanup on shutdown
    if let Err(err) = card.delete_from_nats(nats_client).await {
        tracing::error!(%err, "delete_from_nats error on shutdown");
    }
147
    Ok(())
148
}