VK Cloud logo

Foundation Models және MCP бар файлдық сервисді жасау

VK Object Storage көмегімен файлдық қызметті жасауға болады, мұнда объектілік сақтау құрылғысы деректерді сақтаудың негізгі жүйесі болып табылады, ал Foundation Models және MCP (Model Context Protocol) қолданбаны әзірлеу мен деплойдауды жеделдетеді. VK Object Storage S3-үйлесімді API қамтамасыз етеді, бұл файлдарды жүктеп салу, жүктеу және басқару үшін стандартты SDK (мысалы, Python үшін Boto3) пайдалануға мүмкіндік береді.

Мысал ретінде кейіннен мына деректер қолданылады:

  • Бакет атауы: ai-file-service-bucket
  • Аймақ: ru-msk (Мәскеу)
  • Endpoint URL: https://hb.ru-msk.vkcloud-storage.ru
  • S3-кілттер: <ACCESS_KEY> және <SECRET_KEY>

Дайындық қадамдары

  1. VK Object Storage қызметіне аккаунт жасаңыз, егер ол әлі жасалмаса:

    1. VK Cloud жеке кабинетіне өтіңіз.

    2. Жобаны таңдаңыз.

    3. Object Storage → Аккаунтар бөліміне өтіңіз.

    4. Добавить аккаунт немесе Добавить түймесін басыңыз.

    5. Аккаунт атауын қойыңыз.

    6. Создать түймесін басыңыз.

    7. Ашылған терезеде қолжетімділік кілтінің идентификаторын (Access Key ID) және құпия кілтті (Secret Key) көшіріп сақтаңыз.

  2. Мәскеу аймағында бакет жасаңыз ai-file-service-bucket.

  3. AWS CLI орнатылғанын және жасалған VK Object Storage аккаунтымен жұмыс істеуге бапталғанын тексеріңіз.

  4. Бакетке қосылу деректерін конфигурацияға көрсетіңіз:

    [default]region = ru-mskoutput = jsons3 =    addressing_style = path
  5. Python 3.10+ және pip пакеттік менеджері орнатылғанын тексеріңіз.

  6. Boto3 — Python үшін ресми SDK орнатыңыз:

    pip install boto3
  7. VK Cloud Foundation Models және MCP-серверіне қолжетімділігіңіз бар екенін тексеріңіз.

1. Foundation Models көмегімен қолданба жасаңыз

Файлдық қызметтің қаңқасын жасау үшін Foundation Models пайдаланыңыз. Модель үшін тапсырманы сипаттайтын промпт құрастырыңыз: S3-үйлесімді сақтау құрылғысында сақталатын файлдарды жүктеп салу, жүктеу және оларға сілтемелер алу функциялары бар Python (Flask/FastAPI) веб-қолданбасы.

Foundation Models үшін промпт мысалы:

Python (FastAPI) негізінде файлдық қызмет үшін веб-қолданба жаса.Қолданба мыналарды орындауы тиіс:- Файлдарды HTTP POST-сұранысы арқылы қабылдап, оларды S3-үйлесімді сақтау құрылғысына (Boto3) жүктеп салу.- Жүктеп салынған файлдардың тізімін қайтару.- Файлдарды жүктеп алу үшін presigned URL жасау.- Конфигурация үшін орта айнымалыларын пайдалану (endpoint, access key, secret key, bucket name).

Жасалған кодты жобаның директориясына сақтаңыз, мысалы ai-file-service/.

2. VK Object Storage сақтау құрылғысына файлдарды жүктеп салуды баптаңыз

VK Object Storage қызметімен Boto3 арқылы жұмыс істеуге қолданбаны баптаңыз. SDK-ның стандартты AWS эндпоинттеріне қосылу әрекеттерін болдырмау үшін S3-клиентті endpoint_url және region_name көрсете отырып инициализациялаңыз.

Boto3 клиентін инициализациялау мысалы:

import boto3from botocore.client import Configimport os# Орта айнымалыларынан алынған тіркелгі деректері мен параметрлерaccess_key = os.environ.get('S3_ACCESS_KEY')secret_key = os.environ.get('S3_SECRET_KEY')endpoint_url = os.environ.get('S3_ENDPOINT_URL', 'https://hb.ru-msk.vkcloud-storage.ru')region_name = os.environ.get('S3_REGION', 'ru-msk')bucket_name = os.environ.get('S3_BUCKET_NAME', 'ai-file-service-bucket')# S3 клиентін инициализациялауs3_client = boto3.client(    's3',    endpoint_url=endpoint_url,    aws_access_key_id=access_key,    aws_secret_access_key=secret_key,    region_name=region_name,    config=Config(s3={'addressing_style': 'path'}, request_checksum_calculation="when_required", response_checksum_validation=None))

Файлды бакетке жүктеп салу функциясының мысалы:

def upload_file(file_data: bytes, object_key: str) -> str:    """Файлды VK Object Storage сақтау құрылғысына жүктеп салады және объект кілтін қайтарады."""    s3_client.put_object(        Bucket=bucket_name,        Key=object_key,        Body=file_data    )    return object_key

Файлды жүктеп алу үшін presigned URL жасау функциясының мысалы:

def generate_download_url(object_key: str, expiration: int = 3600) -> str:    """Файлды жүктеп алу үшін presigned URL жасайды."""    url = s3_client.generate_presigned_url(        'get_object',        Params={'Bucket': bucket_name, 'Key': object_key},        ExpiresIn=expiration    )    return url

Жүктеп салынған файлдардың тізімін алу функциясының мысалы:

def list_files() -> list:    """Бакеттегі объектілердің тізімін қайтарады."""    response = s3_client.list_objects_v2(Bucket=bucket_name)    if 'Contents' in response:        return [obj['Key'] for obj in response['Contents']]    return []

Қолданба үшін орта айнымалыларын баптаңыз:

export S3_ACCESS_KEY=<ACCESS_KEY>export S3_SECRET_KEY=<SECRET_KEY>export S3_ENDPOINT_URL=https://hb.ru-msk.vkcloud-storage.ruexport S3_REGION=ru-mskexport S3_BUCKET_NAME=ai-file-service-bucket

3. Файлдарды сақтау мен сілтемелерді алуды тексеріңіз

Қолданбаны локально іске қосыңыз және VK Object Storage қызметімен жұмысты тексеріңіз.

  1. Қолданбаны іске қосыңыз:

    cd ai-file-serviceuvicorn main:app --host 0.0.0.0 --port 8000
  2. HTTP-сұраныс арқылы сынақ файлын жүктеп салыңыз:

    curl -X POST http://localhost:8000/upload \  -F "file=@test-document.txt"
  3. AWS CLI көмегімен файл бакетте пайда болғанын тексеріңіз:

    aws s3 ls s3://ai-file-service-bucket --endpoint-url https://hb.ru-msk.vkcloud-storage.ru
  4. Файлды жүктеп алу үшін presigned URL сұраңыз:

    curl http://localhost:8000/download-url/test-document.txt
  5. Файлды алынған сілтеме бойынша жүктеп алыңыз және мазмұны түпнұсқамен сәйкес келетінін тексеріңіз.

4. MCP-серверін қосыңыз

MCP (Model Context Protocol) қолданбаны жинау мен деплойдауды автоматтандыруға мүмкіндік береді. VK Cloud инфрақұрылымын біртұтас интерфейс арқылы басқару үшін MCP-серверін жобаңызға қосыңыз.

  1. MCP-клиентті орнатыңыз және VK Cloud MCP-серверіне қосылуды баптаңыз.
  2. VK Object Storage қызметімен жұмыс істеу үшін MCP-серверін баптаңыз: MCP конфигурациясында endpoint URL, қолжетімділік кілттері және ai-file-service-bucket бакетінің атауын көрсетіңіз.
  3. MCP-серверінің VK Cloud ресурстарына қолжетімділігі бар екенін тексеріңіз: контейнерлік қолданбаларды жасай алуы және басқара алуы, бакеттердің конфигурациясын оқи алуы тиіс.

5. MCP арқылы қолданбаны Container Apps ішінде жинаңыз және деплойлаңыз

Docker-бейнесін жинауды және қолданбаны Container Apps ішіне деплойдауды автоматтандыру үшін MCP пайдаланыңыз.

  1. Қолданба үшін Dockerfile жасаңыз:

    FROM python:3.12-slimWORKDIR /appCOPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txtCOPY . .CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
  2. requirements.txt файлын жасаңыз:

    fastapiuvicornboto3python-multipart
  3. MCP-сервері арқылы бейнені жинауды және Container Apps ішіне деплойдауды орындаңыз.

  4. Орта айнымалыларын контейнерлік қолданбаға беріңіз:

    • S3_ACCESS_KEY — <ACCESS_KEY>
    • S3_SECRET_KEY — <SECRET_KEY>
    • S3_ENDPOINT_URL — https://hb.ru-msk.vkcloud-storage.ru
    • S3_REGION — ru-msk
    • S3_BUCKET_NAME — ai-file-service-bucket

6. Қолданбаның жұмысын және VK Object Storage ішіндегі деректерді сақтауды тексеріңіз

  1. Container Apps ішінде орналастырылған қолданбаның URL мекенжайын алыңыз.

  2. Орналастырылған қолданба арқылы сынақ файлын жүктеп салыңыз:

    curl -X POST https://<URL_ПРИЛОЖЕНИЯ>/upload \  -F "file=@test-document.txt"
  3. Файлдың ai-file-service-bucket бакетінде пайда болғанын тексеріңіз:

    aws s3 ls s3://ai-file-service-bucket --endpoint-url https://hb.ru-msk.vkcloud-storage.ru
  4. Қолданба API арқылы файлдардың тізімін сұраңыз:

    curl https://<URL_ПРИЛОЖЕНИЯ>/files
  5. Presigned URL алыңыз және сақтау құрылғысының дұрыс жұмыс істеуіне көз жеткізу үшін файлды жүктеп алыңыз:

    curl https://<URL_ПРИЛОЖЕНИЯ>/download-url/test-document.txt
  6. Файлды алынған сілтеме бойынша жүктеп алыңыз және мазмұнын тексеріңіз.

Пайдаланылмайтын ресурстарды жойыңыз

Жасалған ресурстар тарифтеленеді. Егер олар сізге қажет болмаса:

  • Container Apps ішіндегі контейнерлік қолданбаны жойыңыз.
  • Бакетті жойыңыз ai-file-service-bucket.
Мақала пайдалы болды ма?