Struct mz_storage::client::controller::hosts::StorageHosts

source · [−]

pub struct StorageHosts<T> {
    pub build_info: &'static BuildInfo,
    orchestrator: Arc<dyn NamespacedOrchestrator>,
    storaged_image: String,
    hosts: HashMap<String, StorageHost<T>>,
    objects: HashMap<GlobalId, String>,
}

Expand description

Manages provisioning of storage hosts and assignment of storage objects to those hosts.

See the module documentation for details.

Fields

build_info: &'static BuildInfo

The build information for this process.

orchestrator: Arc<dyn NamespacedOrchestrator>

An orchestrator to start and stop storage hosts.

storaged_image: String

The storaged image to use when starting new storage hosts.

hosts: HashMap<String, StorageHost<T>>

The known storage hosts, identified by network address.

objects: HashMap<GlobalId, String>

The assignment of storage objects to storage hosts.

Implementations

source

impl<T> StorageHosts<T>

source

pub fn new(config: StorageHostsConfig) -> StorageHosts<T>

Constructs a new StorageHosts from its configuration.

source

pub async fn provision(
 &mut self,
 id: GlobalId,
 host_addr: Option<String>
) -> Result<&mut RehydratingStorageClient<T>, Error> where
 T: Timestamp + Lattice,
 StorageCommand<T>: RustType<ProtoStorageCommand>,
 StorageResponse<T>: RustType<ProtoStorageResponse>,

Provisions a storage host for the storage object with the specified ID.

If remote_addr is Some, then the specified storage host is used. Otherwise, a storage host is assigned automatically.

At present, the policy for storage host assignment creates a new storage host for each storage object. This policy is subject to change.

Returns a client to the provisioned host. The client may be retrieved in the future via the client method.

Panics

Panics if id is already provisioned.

source

pub async fn deprovision(&mut self, id: GlobalId) -> Result<(), Error>

Deprovisions the storage host for the storage object with the specified ID.

Panics

Panics if the provided id has not been provisioned.

source

pub fn client(
&mut self,
id: GlobalId
) -> Option<&mut RehydratingStorageClient<T>>

Retrives the client for the storage host for the given ID, if the ID is currently provisioned.

source

pub fn clients(
&mut self
) -> impl Iterator<Item = &mut RehydratingStorageClient<T>>

Returns an iterator over clients for all known storage hosts.

source

async fn start_storage_host(&self, id: GlobalId) -> Result<String, Error>

Starts a orchestrated storage host for the specified ID.

source

async fn stop_storage_host(&self, id: GlobalId) -> Result<(), Error>

Stops an orchestrated storage host for the specified ID.

Trait Implementations

source

impl<T: Debug> Debug for StorageHosts<T>

source

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations

impl<T> !RefUnwindSafe for StorageHosts<T>

impl<T> Send for StorageHosts<T> where
T: Send,

impl<T> Sync for StorageHosts<T> where
T: Send,

impl<T> Unpin for StorageHosts<T>

impl<T> !UnwindSafe for StorageHosts<T>

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T> FutureExt for T

source

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more

source

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> IntoRequest<T> for T

source

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request

source

impl<T> Pointable for T

source

const ALIGN: usize = mem::align_of::()

The alignment of pointer.

type Init = T

The type for initializers.

source

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

source

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

source

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

source

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

source

fn vzip(self) -> V

source

impl<T> WithSubscriber for T

source

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

source

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

Struct mz_storage::client::controller::hosts::StorageHosts

Fields

Implementations

impl<T> StorageHosts<T>

pub fn new(config: StorageHostsConfig) -> StorageHosts<T>

pub async fn provision( &mut self, id: GlobalId, host_addr: Option<String>) -> Result<&mut RehydratingStorageClient<T>, Error> where T: Timestamp + Lattice, StorageCommand<T>: RustType<ProtoStorageCommand>, StorageResponse<T>: RustType<ProtoStorageResponse>,

pub async fn deprovision(&mut self, id: GlobalId) -> Result<(), Error>

pub fn client( &mut self, id: GlobalId) -> Option<&mut RehydratingStorageClient<T>>

pub fn clients( &mut self) -> impl Iterator<Item = &mut RehydratingStorageClient<T>>

async fn start_storage_host(&self, id: GlobalId) -> Result<String, Error>

async fn stop_storage_host(&self, id: GlobalId) -> Result<(), Error>

Trait Implementations

impl<T: Debug> Debug for StorageHosts<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Auto Trait Implementations

impl<T> !RefUnwindSafe for StorageHosts<T>

impl<T> Send for StorageHosts<T> where T: Send,

impl<T> Sync for StorageHosts<T> where T: Send,

impl<T> Unpin for StorageHosts<T>

impl<T> !UnwindSafe for StorageHosts<T>

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self>

fn with_current_context(self) -> WithContext<Self>

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> IntoRequest<T> for T

fn into_request(self) -> Request<T>

impl<T> Pointable for T

const ALIGN: usize = mem::align_of::()

type Init = T

unsafe fn init(init: <T as Pointable>::Init) -> usize

unsafe fn deref<'a>(ptr: usize) -> &'a T

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

unsafe fn drop(ptr: usize)

impl<P, R> ProtoType<R> for P where R: RustType<P>,

fn into_rust(self) -> Result<R, TryFromProtoError>

fn from_rust(rust: &R) -> P

impl<T> Same<T> for T

type Output = T

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for T where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self>

pub async fn provision(
&mut self,
id: GlobalId,
host_addr: Option<String>
) -> Result<&mut RehydratingStorageClient<T>, Error> where
T: Timestamp + Lattice,
StorageCommand<T>: RustType<ProtoStorageCommand>,
StorageResponse<T>: RustType<ProtoStorageResponse>,

pub fn client(
&mut self,
id: GlobalId
) -> Option<&mut RehydratingStorageClient<T>>

pub fn clients(
&mut self
) -> impl Iterator<Item = &mut RehydratingStorageClient<T>>

impl<T> Send for StorageHosts<T> where
T: Send,

impl<T> Sync for StorageHosts<T> where
T: Send,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<P, R> ProtoType<R> for P where
R: RustType<P>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,