

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Amazon EKS 連線至 Amazon Keyspaces 的先決條件
<a name="EKS-tutorial-prerequisites"></a>

**請先建立下列 AWS 資源，再開始教學課程**

1. 開始本教學課程之前，請遵循中的 AWS 設定說明[存取 Amazon Keyspaces （適用於 Apache Cassandra)](accessing.md)。這些步驟包括註冊 AWS 和建立可存取 Amazon Keyspaces 的 AWS Identity and Access Management (IAM) 主體。

1. 在本教學課程稍後從在 Amazon EKS 中執行的容器化應用程式建立名稱為 的 Amazon Keyspaces 金鑰空間`aws`和名稱`user`為 的資料表。您可以使用 AWS CLI 或使用 來執行此操作`cqlsh`。

------
#### [ AWS CLI ]

   ```
   aws keyspaces create-keyspace --keyspace-name 'aws'
   ```

   若要確認金鑰空間已建立，您可以使用下列命令。

   ```
   aws keyspaces list-keyspaces
   ```

   若要建立資料表，您可以使用下列命令。

   ```
   aws keyspaces create-table --keyspace-name 'aws' --table-name 'user' --schema-definition 'allColumns=[
               {name=username,type=text}, {name=fname,type=text},{name=last_update_date,type=timestamp},{name=lname,type=text}],
               partitionKeys=[{name=username}]'
   ```

   若要確認您的資料表已建立，您可以使用下列命令。

   ```
   aws keyspaces list-tables --keyspace-name 'aws'
   ```

   如需詳細資訊，請參閱《 *AWS CLI 命令參考*》中的[建立金鑰空間](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/keyspaces/create-keyspace.html)和[建立資料表](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/keyspaces/create-table.html)。

------
#### [ cqlsh ]

   ```
   CREATE KEYSPACE aws WITH replication = {'class': 'SimpleStrategy', 'replication_factor': '3'}  AND durable_writes = true;
   CREATE TABLE aws.user (
       username text PRIMARY KEY,
       fname text,
       last_update_date timestamp,
       lname text
   );
   ```

   若要確認您的資料表已建立，您可以使用下列陳述式。

   ```
   SELECT * FROM system_schema.tables WHERE keyspace_name = "aws";
   ```

   您的資料表應列於此陳述式的輸出中。請注意，在建立資料表之前，可能會有延遲。如需詳細資訊，請參閱[CREATE TABLE](cql.ddl.table.md#cql.ddl.table.create)。

------

1. 使用 **Fargate - Linux **節點類型建立 Amazon EKS 叢集。Fargate 是一種無伺服器運算引擎，可讓您部署 Kubernetes Pod，而無需管理 Amazon EC2 執行個體。若要遵循本教學課程，而無需更新所有範例命令中的叢集名稱，`my-eks-cluster`請依照《[Amazon EKS 使用者指南》中的 Amazon EKS `eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html) 入門中的指示，使用名稱建立叢集。 **建立叢集時，請確認您的節點和兩個預設 Pod 正在執行且運作狀態良好。您可以使用下列命令來執行此操作。

   ```
   kubectl get pods -A -o wide
   ```

   您應該會看到類似此輸出的內容。

   ```
   NAMESPACE     NAME                       READY   STATUS    RESTARTS   AGE   IP          NODE                                                NOMINATED NODE   READINESS GATES
   kube-system   coredns-1234567890-abcde   1/1     Running   0          18m   192.0.2.0   fargate-ip-192-0-2-0.region-code.compute.internal   <none>           <none>
   kube-system   coredns-1234567890-12345   1/1     Running   0          18m   192.0.2.1   fargate-ip-192-0-2-1.region-code.compute.internal   <none>           <none>
   ```

1. 安裝 Docker. 如需如何在 Amazon EC2 執行個體上安裝 Docker 的說明，請參閱[《Amazon Elastic Container Registry 使用者指南》中的安裝 Docker](https://docs.aws.amazon.com/AmazonECR/latest/userguide/getting-started-cli.html#getting-started-cli-prereqs)。

   Docker 可在多個不同的作業系統上使用，包括大部分的現代 Linux 發行版本，例如 Ubuntu，甚至是 macOS 和 Windows。如需如何在特定作業系統上安裝 Docker 的詳細資訊，請前往「[Docker 安裝指南](https://docs.docker.com/engine/install/#installation)」。

1. 建立 Amazon ECR 儲存庫。Amazon ECR 是一種 AWS 受管容器映像登錄服務，可與您偏好的 CLI 搭配使用，以推送、提取和管理 Docker 映像。如需 Amazon ECR 儲存庫的詳細資訊，請參閱《[Amazon Elastic Container Registry 使用者指南](https://docs.aws.amazon.com/AmazonECR/latest/userguide/)》。您可以使用下列命令來建立名為 的儲存庫`my-ecr-repository`。

   ```
   aws ecr create-repository --repository-name my-ecr-repository
   ```

完成先決條件步驟後，請繼續 [步驟 1：設定 Amazon EKS 叢集和設定 IAM 許可](EKS-tutorial-step1.md)。