Skip to content

BEP-1038-image-v2-gql-implementation.md

Latest commit

 

History

History
98 lines (75 loc) · 2.94 KB

BEP-1038-image-v2-gql-implementation.md

File metadata and controls

98 lines (75 loc) · 2.94 KB
Author Gyubong Lee (gbl@lablup.com)
Status Draft
Created 2026-01-26
Created-Version 26.2.0
Target-Version 26.2.0
Implemented-Version

BEP-1038: ImageV2 GQL Implementation

Overview

This document defines the implementation plan for ImageV2GQL types as part of the Strawberry GraphQL migration (BEP-1010). It specifies:

  1. Types to Include - Types that will be implemented
  2. Types to Defer - Types requiring Node connections (implement later)

Note: Enums are directly exposed from existing definitions. Mutations, Filters, and OrderBy types are out of scope for this BEP.

Document Structure

Document Description
types-to-include.md Detailed specifications of types to implement
types-to-defer.md Types requiring Node connections

Summary

Types to Include

Sub-Info Types (Leaf)

  • ImageTagEntryGQL - Tag key-value pair
  • ImageLabelEntryGQL - Label key-value pair
  • ImageResourceLimitGQL - Resource limit info

Info Types (Grouped)

  • ImageIdentityInfoGQL - Identity info (canonical_name, namespace, architecture)
  • ImageMetadataInfoGQL - Metadata info (tags, labels, digest, size_bytes, status, created_at)
  • ImageRequirementsInfoGQL - Requirements info (resource_limits, supported_accelerators)
  • ImagePermissionInfoGQL - Permission info (permissions)

Main Types

  • ImageV2GQL - Main image node type
  • ImageEdgeGQL - Edge type
  • ImageConnectionV2GQL - Connection type

Types to Defer (Node Connections)

Type/Field Future Node Action
ImageV2GQL.registry ContainerRegistryNode Return primitive string for now

Type Structure

ImageV2GQL
├── id: NodeID[UUID]
│
├── identity: ImageIdentityInfoGQL       # Image identity information
│   ├── canonical_name
│   ├── namespace
│   └── architecture
│
├── metadata: ImageMetadataInfoGQL       # Metadata information
│   ├── tags
│   ├── labels
│   ├── digest
│   ├── size_bytes
│   ├── status
│   └── created_at
│
├── requirements: ImageRequirementsInfoGQL  # Runtime requirements
│   ├── resource_limits
│   └── supported_accelerators
│
├── permission: ImagePermissionInfoGQL   # RBAC permissions
│   └── permissions
│
├── registry_id: UUID                    # Registry ID (for direct query)
└── registry: ContainerRegistryNode      # (deferred)

Implementation Checklist

PR Scope

  • Implement all types listed in "Types to Include"
  • Implement connection resolver with pagination

Future PRs

  • ContainerRegistryNode PR: Replace registry string with connection

References