Struct flytrap::Resolver

pub struct Resolver(/* private fields */);

Available on crate feature dns only.

Query the Fly.io internal DNS records.

Implementations

impl Resolver

pub fn new() -> Result<Self, Error>

Available on crate features detect or environment only.

Create a Resolver which configures itself based on the host’s detected Fly.io private network address.

If the host does not appear to be running under Fly.io or connected to the Wireguard VPN, an Unavailable error will be returned.

pub fn with_source(source: SocketAddr, local: Option<SocketAddr>) -> Self

Create a Resolver which will send DNS queries to the given source server to determine your Fly.io application topology.

If local is specified, sockets used to send DNS queries will be bound to the given address.

pub fn with_sources( sources: impl IntoIterator<Item = SocketAddr>, local: Option<SocketAddr> ) -> Self

Create a Resolver which will send DNS queries to the given sources to determine your Fly.io application topology.

To set sources automatically based on the operating systems’ DNS resolution configuration, see Resolver::system.

If local is specified, sockets used to send DNS queries will be bound to the given address.

pub fn system() -> Result<Self, Error>

Available on crate feature system-resolver only.

Create a Resolver which will send DNS queries to the nameservers configured in the host operating system (i.e., in /etc/resolv.conf).

pub fn app(&self, name: impl Into<String>) -> AppResolver<'_>

Create an AppResolver for querying the named app.

pub fn current(&self) -> Result<AppResolver<'_>, Error>

Available on crate feature environment only.

Create an AppResolver for querying the running app (as set by $FLY_APP_NAME).

If $FLY_APP_NAME is unset, an Unavailable error is returned.

pub async fn apps(&self) -> Result<Vec<String>, Error>

Find all apps in the current Fly.io organization.

pub async fn instances(&self) -> Result<Vec<Instance>, Error>

Find all running instances in the current Fly.io organization, across all apps.

pub async fn txt(&self, name: impl IntoName) -> Result<String, Error>

Perform an arbitrary TXT record query on the .internal domain.

Trait Implementations

impl Clone for Resolver

fn clone(&self) -> Resolver

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<AsyncResolver<GenericConnector<TokioRuntimeProvider>>> for Resolver

fn from(value: TokioAsyncResolver) -> Self

Converts to this type from the input type.