# auction

**Repository Path**: mirrors_cloudfoundry/auction

## Basic Information

- **Project Name**: auction
- **Description**: Auction encodes Diego's long-running-process distribution algorithm
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> [!CAUTION]
> This repository has been in-lined (using git-subtree) into diego-release. Please make any
> future contributions directly to diego-release.

# Auction

[![Go Report
Card](https://goreportcard.com/badge/code.cloudfoundry.org/auction)](https://goreportcard.com/report/code.cloudfoundry.org/auction)
[![Go
Reference](https://pkg.go.dev/badge/code.cloudfoundry.org/auction.svg)](https://pkg.go.dev/code.cloudfoundry.org/auction)

This repository contains the source code for the Cloud Foundry package
responsible for the details behind Diego's scheduling mechanism.

> \[!NOTE\]
>
> This repository should be imported as `code.cloudfoundry.org/auction`.

There are two components in Diego that participate in auctions:

-   **The Auctioneer** is responsible for holding auctions whenever a
    Task or LongRunningProcess needs to be scheduled. The Auctioneers
    run on the Diego "Brain" nodes, and there is only ever one active
    Auctioneer at a time (determined by acquiring a lock in Locket). The
    Auctioneer communicates with Reps on all Cells when holding an
    auction.
-   **The Rep** represents a Diego Cell in the auction by making bids
    and, if picked as the winner, running the Task or
    LongRunningProcess. There is one Rep running on every Diego Cell.

# Docs

-   [The Auction Runner](./docs/010-auction-runner.md)
-   [The Simulation](./docs/020-the-simulation.md)

# Contributing

See the [Contributing.md](./.github/CONTRIBUTING.md) for more
information on how to contribute.

# Working Group Charter

This repository is maintained by [App Runtime
Platform](https://github.com/cloudfoundry/community/blob/main/toc/working-groups/app-runtime-platform.md)
under `Diego` area.

> \[!IMPORTANT\]
>
> Content in this file is managed by the [CI task
> `sync-readme`](https://github.com/cloudfoundry/wg-app-platform-runtime-ci/blob/main/shared/tasks/sync-readme/metadata.yml)
> and is generated by CI following a convention.