Cloud Accounts Guide

Connect named cloud accounts, inspect their identities, and disconnect them without deleting their resources. Choose a saved profile or a service account when you need separate accounts for work and automation.

lnk cloud connect aws
lnk cloud list

Connect a Cloud Account

Connecting makes nothing in the account. The same account and its one sign-in keep your buckets too.

lnk cloud connect aws
lnk cloud connect aws --profile work --region eu-west-2
lnk cloud connect aws --name aws-work --key-id AKIAEXAMPLE
lnk cloud connect gcp --project my-project --zone europe-west1-b
lnk cloud connect gcp --name gcp-ci --credential-file key.json
lnk cloud list

Google Cloud

A Google Cloud account uses gcloud's login and project, and signs you in to gcloud first if you aren't. It signs you in once more for buckets, because Google's libraries can't use gcloud's own login. A service account connects by its key instead, which you get from the Google Cloud console under IAM, Service accounts, Keys.

Without the Cloud's CLI

connect offers to install it in Link's settings folder, with no administrator rights. If you say no, an AWS account, or a Google Cloud service account connected by its key, still works for buckets but not for boxes. A Google Cloud login can't connect without gcloud.

Accounts from a Sign-in

An installed module can expose a cloud account from a sign-in it already holds. lnk cloud list and every command using that account discover it automatically, with no connect or saved duplicate. Sign out through the module that supplied it to remove that connection.

Other Clouds

connect takes any kind whose adapter, lnk-<kind>, Link finds. A machine of your Local Cloud connects as kind local, with the adapter's own settings given as --setting; it is not an AWS or Google Cloud account and holds no cloud CLI.

Show an Account

lnk cloud show shows one account's kind, place and the identity it signs in as, and never its credential.

lnk cloud show aws

Disconnect an Account

Disconnecting forgets the account and its key, and deletes nothing in it.

lnk cloud disconnect aws-work

What Waits for It

Its boxes and buckets wait until you connect it again, and lnk storage disconnect forgets its buckets. An access key keeps working until you delete it in the cloud's console.

How It Runs

Each cloud's adapter runs as its own program, lnk-aws and lnk-gcp, and the commands exchange typed requests and replies with it (Interface).