English Portuguese (Brazil)
Provisioning Fedora CoreOS on IBM Cloud Provisionando o Fedora CoreOS na IBM Cloud
This guide shows how to provision new Fedora CoreOS (FCOS) instances in IBM Cloud VPC Generation 2. Esse guia mostra como provisionar instâncias novas do Fedora CoreOS (FCOS) no IBM Cloud VPC Generation 2.
Prerequisites Pré-Requisitos
Before provisioning a FCOS instance, you must have an Ignition configuration file containing your customizations. If you do not have one, see xref:producing-ign.adoc[Producing an Ignition File]. Antes de provisionar uma instância FCOS, você deve ter um arquivo de configuração do Ignition contendo suas personalizações. Se você não tiver um, consulte xref:production-ign.adoc[Produzindo um arquivo de Ignition].
You also need to have access to an https://cloud.ibm.com/login[IBM Cloud account]. The examples below use the https://cloud.ibm.com/docs/cli?topic=cli-getting-started[`ibmcloud`] command-line tool, which must be separately installed and configured beforehand. There are also several pieces that need to be in place first, like a VPC, SSH keys, networks, permissions, etc. Unfortunately, this guide is not a comprehensive IBM Cloud guide. If you are new to IBM Cloud please familiarize yourself using https://cloud.ibm.com/docs/vpc?topic=vpc-getting-started[the documentation for VPC Gen2] first. Você também deverá ter acesso a uma https://cloud.ibm.com/login[Conta IBM Cloud]. Os exemplos mostrados abaixo usam a ferramenta de linha de comando https://cloud.ibm.com/docs/cli?topic=cli-getting-started[`ibmcloud`], que deve ser separadamente instalada e configurada previamente. Também há vários elementos que devem ser colocados no lugar, como uma VPC, chaves SSH, redes, permissões, etc. Infelizmente, esse guia não é um guia compreensível para IBM Cloud. Se você é novo na IBM Cloud, por favor familiarize-se usando https://cloud.ibm.com/docs/vpc?topic=vpc-getting-started[a documentação pra o VPC Gen2].
Regarding the `ibmcloud` CLI, it is worth noting that it is supported to run the CLI https://cloud.ibm.com/docs/cli?topic=cli-using-idt-from-docker[via a container]. You'll need both the `cloud-object-storage` and `infrastructure-service` plugins installed. This can be done with: Desconsiderando a CLI `ibmcloud`, vale a pena lembrar que rodar a CLI https://cloud.ibm.com/docs/cli?topic=cli-using-idt-from-docker[por um contêiner] também é suportado. Você precisará dos plugins `cloud-object-storage` e `infrastructure-service` instalados. Isso pode ser feito com:
`ibmcloud plugin install cloud-object-storage` `ibmcloud plugin install cloud-object-storage`
`ibmcloud plugin install infrastructure-service` `ibmcloud plugin install infrastructure-service`
After you've logged in using `ibmcloud login` you can set a target region: Depois de logar usando `ibmcloud login`, você pode colocar uma região alvo:
Target a specific region Escolha uma região específica
REGION='us-east' # run `ibmcloud regions` to view options
ibmcloud target -r $REGION
REGION='us-east' #rode `ibmcloud regions` para ver opções
ibmcloud target -r $REGION
Creating an Image Criando uma imagem
The following sets of commands will show you how to download the most recent image for a stream, upload it to cloud storage, and then create the cloud image in IBM Cloud. It is worth noting that Fedora CoreOS comes in three streams, with different update schedules per stream. These steps show the `stable` stream as an example, but can be used for other streams too. Os seguintes conjuntos de comandos vão mostrar para você como fazer o download da imagem mais recentes para um fluxo, realizar um upload para o armazenamento em nuvem, e então criar a imagem em nuvem na IBM Cloud. Vale a pena notar que o Fedora CoreOS vem em três fluxos, com diferentes rotinas de atualizações por fluxo. Esses passos mostram o fluxo `stable` como exemplo, mas pode ser usado para outros fluxos também.
Fetch the latest image suitable for your target stream (or https://getfedora.org/coreos/download/[download and verify] it from the web). Obtenha a imagem mais recente adequada para o seu fluxo alvo (ou https://getfedora.org/coreos/download/[baixe e verifique] na web).
STREAM='stable'
coreos-installer download -s "${STREAM}" -p ibmcloud -f qcow2.xz --decompress
STREAM='stable'
coreos-installer download -s "${STREAM}" -p vultr -f raw.xz --decompress
Create a Service Account for uploading and an Authorization Policy to allow creating images from the uploaded objects. Crie uma conta de serviço para realizar uploads e uma Política de Autorização que permitem criar imagens para os objetos que sofreram upload.
BUCKET='my-unique-bucket'
ibmcloud resource service-instance-create "${BUCKET}-service-instance" cloud-object-storage standard global
BUCKET='my-unique-bucket'
ibmcloud resource service-instance-create "${BUCKET}-service-instance" cloud-object-storage standard global
SERVICE_INSTANCE_ID='25df0db0-89a4-4cb8-900f-ed8b44259f80' # from just created service account
ibmcloud iam authorization-policy-create is --source-resource-type image cloud-object-storage Reader --target-service-instance-id $SERVICE_INSTANCE_ID
SERVICE_INSTANCE_ID='25df0db0-89a4-4cb8-900f-ed8b44259f80' # pela recém criada conta de serviço
ibmcloud iam authorization-policy-create is --source-resource-type image cloud-object-storage Reader --target-service-instance-id $SERVICE_INSTANCE_ID
Upload the fetched image file to IBM Cloud Object Storage. Realize o upload da imagem obtida para o armazenamento de objeto da IBM Cloud.
FCOS_VERSION='...'
FILE=fedora-coreos-${FCOS_VERSION}-ibmcloud.x86_64.qcow2
ibmcloud cos create-bucket --bucket $BUCKET --ibm-service-instance-id $SERVICE_INSTANCE_ID
ibmcloud cos upload --bucket=$BUCKET --key=$FILE --file=$FILE
FCOS_VERSION='...'
FILE=fedora-coreos-${FCOS_VERSION}-ibmcloud.x86_64.qcow2
ibmcloud cos create-bucket --bucket $BUCKET --ibm-service-instance-id $SERVICE_INSTANCE_ID
ibmcloud cos upload --bucket=$BUCKET --key=$FILE --file=$FILE