EC2PUBLISHIMG-3.13(1)

💖 NAME 💖

okay so this is the ec2publishimg.1 page — yes, EC2PUBLISHIMG-3.13(1) — and the main character is ec2publishimg: modify the visibility permissions for an AMI. That's the whole name section, bestie. 💅

✨ SYNOPSIS ✨

ec2publishimg [option]

🦋 DESCRIPTION 🦋

ec2publishimg sets the visibility of an AMI so other people can use the image, or makes the image private, i.e. only available to the account owner. periodt.

🌸 OPTIONS 🌸

• -a, --account ACCOUNT_NAME — okay so this specifies the account to use to connect to EC2. The account is specified in the config file ~/.ec2utils.conf. The account is specified as a section with [account-ACCOUNT_NAME] delimiter. The options of the sections are access_key_id, secret_access_key, ssh_key_name, and ssh_private_key. These allow the program to connect to EC2. If the access_key_id and/or secret_access_key are not found in ~/.ec2utils.conf, the search will use ACCOUNT_NAME to look for a matching section [profile ACCOUNT_NAME] in ~/.aws/config or [ACCOUNT_NAME] in ~/.aws/credentials. iykyk.
• --access-id AWS_ACCESS_KEY — Specifies the AWS access key and overrides the value given for the account with the access_key_id in the configuration file.
• --allow-copy — Set the image copy permissions. The option supports the keyword image to allow those that the image is shared with to copy it; the keyword none which does not allow copy access and is the default behavior. The option allows the specification of an AWS account number or a comma separated list with no white space to specify multiple account numbers to allow those accounts to copy the image. copy that, bestie.
• -n, --dry-run — The program will not perform any action. It will provide information on stdout about the actions it would perform. preview vibes.
• -f, --file CONFIG_FILE — Specifies the configuration file to use. The default is ~/.ec2utils.conf.
• --image-id AMI_ID — Specify the AMI ID of the image to be published. This option is mutually exclusive with --image-name, --image-name-frag, and --image-name-match.
• --image-name IMAGE_NAME — Specify the name of the image to be published. The program will look for an exact match of the name. This option is mutually exclusive with --image-id, --image-name-frag, and --image-name-match options.
• --image-name-frag IMAGE_NAME_FRAGMENT — Specify a section of an image name for the image(s) to be published. Every image that matches the name fragment will be published. This option is mutually exclusive with the --image-id, --image-name-name, and --image-name-match options. (Yup, --image-name-name — that's literally what the page says, I'm not correcting it 👀.)
• --image-name-match REGEX — Specify a regular expression to match an image name. Every image matching the regular expression will be published. This option is mutually exclusive with the --image-id, --image-name-name, and --image-name-frag options.
• -r, --regions EC2_REGIONS — A comma separated list of Amazon EC2 regions, or a single region. If no region argument is specified all EC2 connected regions will be processed. EC2 disconnected regions have different API keys and thus the specified account would not work with the disconnected regions. If a disconnected region is to be processed specify the region explicitly on the command line, and only the region of interest along with the matching account. important caveat, bestie.
• -s, --secret-key AWS_SECRET_KEY — Specifies the AWS secret access key and overrides the value given for the account with the secret_access_key in the configuration file.
• --share-with SHARE — Specify the scope of the image publishing/sharing. The option supports the keyword all to set the image to public, the keyword none to set the image private, or expects an AWS account number to share the image with a specific account. Use a comma separated list with no white space to specify multiple account numbers. By default the selected image will be published, i.e. all is the default value. default is public, noted.
• --verbose — Print extra output about the operations performed to STDOUT.
• --version — Print the version of he program. (The original page says he, and honestly? iconic typo, keeping it 💀.)

🌈 EXAMPLE 🌈

ec2publishimg --account example --image-name-match production-v2
       --share-with all

Will set all images in all connected regions that match the production-v2 regular expression as public. ate.

👑 AUTHOR 👑

Robert Schweikert (rjschwei@suse.com)

That's the whole ec2publishimg.1 page, EC2PUBLISHIMG-3.13(1) — source/version is right there in the page name, and the footer has no date line, so this is the cute sign-off: bye bestie, go forth and publish responsibly 💖✨💅