Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# `pcluster`
`pcluster`adalah perintah AWS ParallelCluster CLI utama. Anda gunakan `pcluster` untuk meluncurkan dan mengelola cluster HPC di. AWS Cloud
`pcluster`menulis log perintah Anda ke `pcluster.log.#` file di`/home/user/.parallelcluster/`. Untuk informasi selengkapnya, lihat [`pcluster`Log CLI](troubleshooting-v3-pc-cli-logs.md).
Untuk menggunakannya`pcluster`, Anda harus memiliki peran IAM dengan [izin](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-example-user-policies) yang diperlukan untuk menjalankannya.
```
pcluster [-h]
```
## Pendapat
**`pcluster command`**
Pilihan yang memungkinkan: [`build-image`[`configure`](pcluster.configure-v3.md)](pcluster.build-image-v3.md)\$1 [`create-cluster`](pcluster.create-cluster-v3.md)\$1 [`dcv-connect`](pcluster.dcv-connect-v3.md)\$1 [`delete-cluster`](pcluster.delete-cluster-v3.md)\$1 [`delete-cluster-instances`](pcluster.delete-cluster-instances-v3.md)\$1 [`delete-image`[`describe-cluster`](pcluster.describe-cluster-v3.md)](pcluster.delete-image-v3.md)\$1 [`describe-cluster-instances`](pcluster.describe-cluster-instances-v3.md)\$1 [`describe-compute-fleet`](pcluster.describe-compute-fleet-v3.md)\$1 [`describe-image`](pcluster.describe-image-v3.md)\$1 [`export-cluster-logs`](pcluster.export-cluster-logs-v3.md)\$1 [`export-image-logs`](pcluster.export-image-logs-v3.md)\$1 [`get-cluster-log-events`](pcluster.get-cluster-log-events-v3.md)\$1 [`get-cluster-stack-events`](pcluster.get-cluster-stack-events-v3.md)\$1 [`get-image-log-events`](pcluster.get-image-log-events-v3.md)\$1 [`get-image-stack-events`](pcluster.get-image-stack-events-v3.md)\$1 [`list-clusters`](pcluster.list-clusters-v3.md)\$1 [`list-cluster-log-streams`](pcluster.list-cluster-log-streams-v3.md)\$1 [`list-images`](pcluster.list-images-v3.md)\$1 [`list-image-log-streams`[`list-official-images`](pcluster.list-official-images-v3.md)](pcluster.list-image-log-streams-v3.md)\$1 [`ssh`](pcluster.ssh-v3.md)\$1 [`update-cluster`](pcluster.update-cluster-v3.md)\$1 [`update-compute-fleet`](pcluster.update-compute-fleet-v3.md)\$1 [`version`](pcluster.version-v3.md)
**Sub-perintah:**
**Topics**
+ [Pendapat](#pcluster.arguments-v3)
+ [`pcluster build-image`](pcluster.build-image-v3.md)
+ [`pcluster configure`](pcluster.configure-v3.md)
+ [`pcluster create-cluster`](pcluster.create-cluster-v3.md)
+ [`pcluster dcv-connect`](pcluster.dcv-connect-v3.md)
+ [`pcluster delete-cluster`](pcluster.delete-cluster-v3.md)
+ [`pcluster delete-cluster-instances`](pcluster.delete-cluster-instances-v3.md)
+ [`pcluster delete-image`](pcluster.delete-image-v3.md)
+ [`pcluster describe-cluster`](pcluster.describe-cluster-v3.md)
+ [`pcluster describe-cluster-instances`](pcluster.describe-cluster-instances-v3.md)
+ [`pcluster describe-compute-fleet`](pcluster.describe-compute-fleet-v3.md)
+ [`pcluster describe-image`](pcluster.describe-image-v3.md)
+ [`pcluster export-cluster-logs`](pcluster.export-cluster-logs-v3.md)
+ [`pcluster export-image-logs`](pcluster.export-image-logs-v3.md)
+ [`pcluster get-cluster-log-events`](pcluster.get-cluster-log-events-v3.md)
+ [`pcluster get-cluster-stack-events`](pcluster.get-cluster-stack-events-v3.md)
+ [`pcluster get-image-log-events`](pcluster.get-image-log-events-v3.md)
+ [`pcluster get-image-stack-events`](pcluster.get-image-stack-events-v3.md)
+ [`pcluster list-clusters`](pcluster.list-clusters-v3.md)
+ [`pcluster list-cluster-log-streams`](pcluster.list-cluster-log-streams-v3.md)
+ [`pcluster list-images`](pcluster.list-images-v3.md)
+ [`pcluster list-image-log-streams`](pcluster.list-image-log-streams-v3.md)
+ [`pcluster list-official-images`](pcluster.list-official-images-v3.md)
+ [`pcluster ssh`](pcluster.ssh-v3.md)
+ [`pcluster update-cluster`](pcluster.update-cluster-v3.md)
+ [`pcluster update-compute-fleet`](pcluster.update-compute-fleet-v3.md)
+ [`pcluster version`](pcluster.version-v3.md)
# `pcluster build-image`
Buat AWS ParallelCluster gambar kustom di Wilayah yang ditentukan.
```
pcluster build-image [-h]
--image-configuration IMAGE_CONFIGURATION
--image-id IMAGE_ID
[--debug]
[--dryrun DRYRUN]
[--query QUERY]
[--region REGION]
[--rollback-on-failure ROLLBACK_ON_FAILURE]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster build-image`.
**--image-configuration, -c *IMAGE\$1CONFIGURATION***
Menentukan file konfigurasi gambar sebagai dokumen YAMG.
**--image-id, -i *IMAGE\$1ID***
Menentukan id dari gambar yang akan dibangun.
**--debug**
Aktifkan logging debug.
**--dryrun *DRYRUN***
Kapan`true`, perintah melakukan validasi tanpa membuat sumber daya apa pun. Anda dapat menggunakan ini untuk memvalidasi konfigurasi gambar. (Default ke.) `false`
**--query *QUERY***
JMESPath query untuk dilakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan pengaturan [Wilayah](image-builder-configuration-file-v3.md#yaml-build-image-Region) dalam file konfigurasi gambar, variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***
Kapan`true`, secara otomatis memulai rollback tumpukan gambar pada kegagalan. (Default ke.) `false`
**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**
Mengidentifikasi satu atau lebih validator konfigurasi untuk ditekan.
Format: (`ALL`\$1`type:[A-Za-z0-9]+`)
**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**
Menentukan tingkat validasi minimum yang akan menyebabkan penciptaan gagal. (Default ke.) `ERROR`
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster build-image --image-configuration image-config.yaml --image-id custom-alinux2-image
{
"image": {
"imageId": "custom-alinux2-image",
"imageBuildStatus": "BUILD_IN_PROGRESS",
"cloudformationStackStatus": "CREATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.2"
}
}
```
**Awas**
`pcluster build-image`menggunakan VPC default. Jika VPC default telah dihapus, mungkin dengan menggunakan AWS Control Tower atau AWS Landing Zone, maka ID subnet harus ditentukan dalam file konfigurasi gambar. Untuk informasi selengkapnya, lihat [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).
# `pcluster configure`
Memulai wizard konfigurasi interaktif untuk AWS ParallelCluster versi 3. Untuk informasi selengkapnya, lihat [Konfigurasikan dan buat cluster dengan antarmuka baris AWS ParallelCluster perintah](install-v3-configuring.md).
```
pcluster configure [-h]
--config CONFIG
[--debug]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster configure`.
**--config *CONFIG***
Jalur untuk menampilkan file konfigurasi yang dihasilkan.
**--debug**
Aktifkan logging debug.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah harus ditentukan, menggunakan pengaturan [Wilayah](image-builder-configuration-file-v3.md#yaml-build-image-Region) dalam file konfigurasi gambar, variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
# `pcluster create-cluster`
Menciptakan sebuah AWS ParallelCluster cluster.
```
pcluster create-cluster [-h]
--cluster-configuration CLUSTER_CONFIGURATION
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--query QUERY]
[--region REGION]
[--rollback-on-failure ROLLBACK_ON_FAILURE]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster create-cluster`.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
Menentukan file konfigurasi cluster YAMG.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster yang akan dibuat.
Nama harus dimulai dengan karakter alfabet. Nama dapat memiliki hingga 60 karakter. Jika Slurm akuntansi diaktifkan, nama dapat memiliki hingga 40 karakter.
Karakter yang valid: a-z, A-Z, 0-9, dan - (tanda hubung).
**--debug**
Mengaktifkan logging debug.
**--dryrun *DRYRUN***
Kapan`true`, perintah melakukan validasi tanpa membuat sumber daya apa pun. Anda dapat menggunakan ini untuk memvalidasi konfigurasi cluster. (Default ke.) `false`
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan [`Region`](cluster-configuration-file-v3.md#yaml-Region)pengaturan dalam file konfigurasi cluster, variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***
Kapan`true`, secara otomatis memulai rollback tumpukan cluster pada kegagalan. (Default ke.) `true`
**--suppress-validators *SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS* ...]**
Mengidentifikasi satu atau lebih validator konfigurasi untuk ditekan.
Format: (`ALL`\$1jenis:`[A-Za-z0-9]+`)
**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**
Menentukan tingkat validasi minimum yang akan menyebabkan penciptaan gagal. (Default ke.) `ERROR`
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster create-cluster -c cluster-config.yaml -n cluster-v3
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "CREATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "CREATE_IN_PROGRESS"
}
}
```
# `pcluster dcv-connect`
Izin untuk terhubung ke node kepala melalui sesi interaktif dengan menggunakan Amazon DCV.
```
pcluster dcv-connect [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--key-path KEY_PATH]
[--login-node-ip LOGIN_NODE_IP]
[--region REGION]
[--show-url]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster dcv-connect`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--key-path *KEY\$1PATH***
Menentukan jalur kunci SSH yang akan digunakan untuk koneksi.
**--login-node-ip**
Menentukan alamat IP publik atau pribadi dari node login di cluster. Menggunakan argumen ini memungkinkan koneksi ke node login di cluster dengan DCV diaktifkan.
Argumen ini ditambahkan dalam AWS ParallelCluster versi 3.11.0.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--show-url**
Mencetak URL yang akan digunakan untuk koneksi DCV dan keluar.
**Contoh menggunakan AWS ParallelCluster versi 3.11**
```
$ pcluster dcv-connect -n cluster-3Dcv --login-node-ip 198.51.100.44 -r us-east-1 --key-path /home/user/.ssh/key.pem
```
![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/id_id/parallelcluster/latest/ug/images/Dcv-image.png)
# `pcluster delete-cluster`
Memulai penghapusan cluster.
```
pcluster delete-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster delete-cluster`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster delete-cluster -n cluster-v3
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "DELETE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "DELETE_IN_PROGRESS"
}
}
```
# `pcluster delete-cluster-instances`
Memulai penghentian paksa dari semua node komputasi cluster. Ini tidak bekerja dengan AWS Batch cluster.
```
pcluster delete-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster delete-cluster-instances`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--force *FORCE***
Kapan`true`, memaksa penghapusan dengan mengabaikan kesalahan validasi. (Default ke.) `false`
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
```
$ pcluster delete-cluster-instances -n cluster-v3
```
# `pcluster delete-image`
Mulai penghapusan gambar kustom AWS ParallelCluster .
```
pcluster delete-image [-h]
--image-id IMAGE_ID
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster delete-image`.
**--image-id, -i *IMAGE\$1ID***
Menentukan id dari gambar yang akan dihapus.
**--debug**
Mengaktifkan logging debug.
**--force *FORCE***
Kapan`true`, memaksa penghapusan jika ada instance yang menggunakan AMI atau jika AMI dibagikan. (Default ke.) `false`
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster delete-image --image-id custom-alinux2-image
{
"image": {
"imageId": "custom-alinux2-image",
"imageBuildStatus": "DELETE_IN_PROGRESS",
"region": "us-east-1",
"version": "3.1.4"
}
}
```
# `pcluster describe-cluster`
Dapatkan informasi rinci tentang cluster.
```
pcluster describe-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster describe-cluster`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
Jelaskan detail cluster:
```
$ pcluster describe-cluster -n cluster-v3
{
"creationTime": "2022-07-12T17:19:16.101Z",
"headNode": {
"launchTime": "2022-07-12T17:22:21.000Z",
"instanceId": "i-1234567890abcdef0",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "running",
"privateIpAddress": "192.0.2.0.196"
},
"loginNodes": [
{
"status": "active",
"poolName": "pool1",
"address": "cluster-v3-eMr9BYRKZVDa-e5bb34f40b24f51d.elb.us-east-1.amazonaws.com",
"scheme": "internet-facing",
"healthyNodes": 1,
"unhealthyNodes": 0
},
{
"status": "active",
"poolName": "pool2",
"address": "cluster-v3-PaQ7GgC27sic-aba10c890247b36b.elb.us-east-1.amazonaws.com",
"scheme": "internet-facing",
"healthyNodes": 1,
"unhealthyNodes": 0
}
],
"version": "3.1.4",
"clusterConfiguration": {
"url": "https://parallelcluster-e5ca74255d6c3886-v1-do-not-delete..."
},
"tags": [
{
"value": "3.11",
"key": "parallelcluster:version"
}
],
"cloudFormationStackStatus": "CREATE_COMPLETE",
"clusterName": "cluster-v3",
"computeFleetStatus": "RUNNING",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"lastUpdatedTime": "2022-07-12T17:19:16.101Z",
"region": "us-east-1",
"clusterStatus": "CREATE_COMPLETE"
}
```
Gunakan `describe-cluster` untuk mengambil konfigurasi cluster:
```
$ curl -o - $(pcluster describe-cluster -n cluster-v3 --query clusterConfiguration.url | xargs echo)
Region: us-east-1
Image:
Os: alinux2
HeadNode:
InstanceType: t2.micro
Networking:
SubnetId: subnet-abcdef01234567890
Ssh:
KeyName: adpc
Iam:
S3Access:
- BucketName: cluster-v3-bucket
KeyName: logs
EnableWriteAccess: true
Scheduling:
Scheduler: slurm
SlurmQueues:
- Name: queue1
ComputeResources:
- Name: t2micro
InstanceType: t2.micro
MinCount: 0
MaxCount: 10
Networking:
SubnetIds:
- subnet-021345abcdef6789
```
# `pcluster describe-cluster-instances`
Jelaskan contoh dalam sebuah cluster.
```
pcluster describe-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--node-type {HeadNode,ComputeNode,LoginNode}]
[--query QUERY]
[--queue-name QUEUE_NAME]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster describe-cluster-instances`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--node-type \$1`HeadNode`,`ComputeNode`,`LoginNode`\$1**
Menentukan jenis node untuk daftar. Nilai yang didukung adalah`HeadNode`, `ComputeNode` dan`LoginNode`. Jika parameter ini tidak ditentukan, contoh`HeadNode`, `ComputeNode` dan `LoginNode` contoh dijelaskan.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--queue-name *QUEUE\$1NAME***
Menentukan nama antrian ke daftar. Jika parameter ini tidak ditentukan, contoh di semua antrian dijelaskan.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster describe-cluster-instances -n cluster-v3
{
"instances": [
{
"launchTime": "2022-07-12T17:22:21.000Z",
"instanceId": "i-1234567890abcdef0",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "running",
"nodeType": "HeadNode",
"privateIpAddress": "192.0.2.0.196"
},
{
"launchTime": "2022-07-12T17:37:42.000Z",
"instanceId": "i-021345abcdef6789",
"queueName": "queue1",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "pending",
"nodeType": "ComputeNode",
"privateIpAddress": "192.0.2.0.196"
},
{
"launchTime": "2022-07-12T17:37:42.000Z",
"instanceId": "i-021345abcdef6789",
"poolName": "pool1",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "pending",
"nodeType": "loginNode",
"privateIpAddress": "192.0.2.0.196"
}
]
}
```
# `pcluster describe-compute-fleet`
Jelaskan status armada komputasi.
```
pcluster describe-compute-fleet [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster describe-compute-fleet`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster describe-compute-fleet -n pcluster-v3
{
"status": "RUNNING",
"lastStatusUpdatedTime": "2022-07-12T17:24:26.000Z"
}
```
# `pcluster describe-image`
Dapatkan informasi rinci tentang sebuah gambar.
```
pcluster describe-image [-h]
--image-id IMAGE_ID
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster describe-image`.
**--image-id, -i *IMAGE\$1ID***
Menentukan ID gambar.
**--debug**
Mengaktifkan logging debug.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster describe-image --image-id custom-alinux2-image
{
"imageConfiguration: {
"url": "https://parallelcluster-1234abcd5678-v1-do-not-delete.../configs/image-config.yaml"
},
"imageId": "custom-alinux2-image",
"creationTime": "2022-04-05T20:23:07.000Z"
"imageBuildStatus": "BUILD_COMPLETE",
"region": "us-east-1",
"ec2AmiInfo": {
"amiName": "custom-alinux2-image 2022-04-05T19-55-22.518Z",
"amiId": "ami-1234abcd5678efgh",
"description": "AWS ParallelCluster AMI for alinux2, kernel-4.14.268-205.500.amzn2.x86_64, lustre-2.10.8-5.amzn2.x86_64, efa-1.14.2-1.amzn2.x86_64, dcv-2021.3.11591-1.el7.x86_64, slurm-21-08-6-1",
"state": "AVAILABLE",
"tags": [
{
"value": "arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-custom-alinux2-image/3.1.2/1",
"key": "Ec2ImageBuilderArn"
},
{
"value": "parallelcluster-1234abcd5678efgh-v1-do-not-delete",
"key": "parallelcluster:amzn-s3-demo-bucket"
},
{
"value": "custom-alinux2-image",
"key": "parallelcluster:image_name"
},
{
"value": "available",
"key": "parallelcluster:build_status"
},
{
"value": "s3://amzn-s3-demo-bucket/parallelcluster/3.1.2/images/custom-alinux2-image-1234abcd5678efgh/configs/image-config.yaml",
"key": "parallelcluster:build_config"
},
{
"value": "Amazon EC2 Image Builder",
"key": "CreatedBy"
},
{
"value": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/imagebuilder/ParallelClusterImage-custom-alinux2-image",
"key": "parallelcluster:build_log"
},
{
"value": "4.14.268-205.500.amzn2.x86_64",
"key": "parallelcluster:kernel_version"
},
{
"value": "arn:aws:imagebuilder:us-east-1:444455556666:image/amazon-linux-2-x86/2022.3.16/1",
"key": "parallelcluster:parent_image"
},
{
"value": "3.1.2",
"key": "parallelcluster:version"
},
{
"value": "0.5.14",
"key": "parallelcluster:munge_version"
},
{
"value": "21-08-6-1",
"key": "parallelcluster:slurm_version"
},
{
"value": "2021.3.11591-1.el7.x86_64",
"key": "parallelcluster:dcv_version"
},
{
"value": "alinux2-image",
"key": "parallelcluster:image_id"
},
{
"value": "3.2.3",
"key": "parallelcluster:pmix_version"
},
{
"value": "parallelcluster/3.15.0/images/alinux2-image-abcd1234efgh56781234",
"key": "parallelcluster:s3_image_dir"
},
{
"value": "1.14.2-1.amzn2.x86_64",
"key": "parallelcluster:efa_version"
},
{
"value": "alinux2",
"key": "parallelcluster:os"
},
{
"value": "aws-parallelcluster-cookbook-3.1.2",
"key": "parallelcluster:bootstrap_file"
},
{
"value": "1.8.23-10.amzn2.1.x86_64",
"key": "parallelcluster:sudo_version"
},
{
"value": "2.10.8-5.amzn2.x86_64",
"key": "parallelcluster:lustre_version"
}
],
"architecture": "x86_64"
},
"version": "3.1.2"
}
```
# `pcluster export-cluster-logs`
Ekspor log cluster ke `tar.gz` arsip lokal dengan melewati Amazon S3 Bucket.
```
pcluster export-cluster-logs [-h]
--cluster-name CLUSTER_NAME
[--bucket BUCKET_NAME]
[--bucket-prefix BUCKET_PREFIX]
[--debug]
[--end-time END_TIME]
[--filters FILTER [FILTER ...]]
[--keep-s3-objects KEEP_S3_OBJECTS]
[--output-file OUTPUT_FILE]
[--region REGION]
[--start-time START_TIME]
```
**catatan**
`export-cluster-logs`Perintah menunggu CloudWatch Log untuk menyelesaikan ekspor log, sehingga diharapkan mengalami periode waktu tanpa output apa pun.
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster export-cluster-logs`.
**--bucket *BUCKET\$1NAME***
Menentukan nama bucket Amazon S3 untuk mengekspor data log klaster ke. Itu harus di Wilayah yang sama dengan cluster.
+ Anda harus menambahkan izin ke kebijakan bucket Amazon S3 untuk CloudWatch memberikan akses. Untuk informasi selengkapnya, lihat [Menetapkan izin pada bucket Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) di CloudWatch Panduan Pengguna *Log*.
+ **Dimulai dengan AWS ParallelCluster versi **3.12.0**, `--bucket` opsi ini opsional.** Jika opsi tidak ditentukan, bucket default AWS ParallelCluster regional (`parallelcluster-hash-v1-DO-NOT-DELETE`) akan digunakan, atau jika bucket Amazon S3 yang ditunjuk oleh `CustomS3Bucket` ditentukan dalam konfigurasi cluster, itu akan digunakan. Jika Anda tidak menentukan `--bucket` opsi dan Anda menggunakan AWS ParallelCluster bucket default, Anda tidak dapat mengekspor log ke `parallelcluster/` folder, karena ini adalah folder yang dilindungi yang dicadangkan untuk penggunaan internal.
Jika bucket AWS ParallelCluster default digunakan, pcluster akan menangani konfigurasi kebijakan bucket. Jika Anda menyesuaikan kebijakan bucket dan kemudian memutakhirkan ke AWS ParallelCluster versi **3.12.0**, kebijakan bucket akan diganti dan Anda perlu menerapkan kembali perubahan Anda.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--bucket-prefix *BUCKET\$1PREFIX***
Menentukan jalur di bucket Amazon S3 tempat data log yang diekspor akan disimpan.
Secara default, awalan ember adalah:
```
cluster-name-logs-202209061743.tar.gz
```
`202209061743`adalah contoh waktu dalam `%Y%m%d%H%M` format.
Dimulai dengan AWS ParallelCluster versi **3.12.0**, jika Anda tidak menentukan `--bucket` opsi dan Anda menggunakan AWS ParallelCluster bucket default, Anda tidak dapat mengekspor log ke `parallelcluster/` folder, karena ini adalah folder yang dilindungi yang dicadangkan untuk penggunaan internal.
**--debug**
Mengaktifkan logging debug.
**--end-time *END\$1TIME***
Menentukan akhir rentang waktu untuk mengumpulkan peristiwa log, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya `2021-01-01T20:00:00Z` '). Acara dengan stempel waktu yang sama dengan atau lebih lambat dari waktu ini tidak termasuk. Elemen waktu (misalnya menit dan detik) dapat dihilangkan. Nilai default adalah waktu ketika ini.
**--filters *FILTER* [*FILTER* ...]**
Menentukan filter untuk log. Format: `Name=a,Values=1 Name=b,Values=2,3`. Filter yang didukung adalah:
`private-dns-name`
Menentukan bentuk singkat dari nama DNS pribadi dari instance (misalnya). `ip-10-0-0-101`
`node-type`
Menentukan jenis node, satu-satunya nilai yang diterima untuk filter ini adalah`HeadNode`.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Jika`true`, objek yang diekspor ekspor ke Amazon S3 disimpan. (Default ke.) `false`
**--output-file *OUTPUT\$1FILE***
Menentukan path file untuk menyimpan arsip log ke. Jika ini disediakan, maka log disimpan secara lokal. Jika tidak, mereka diunggah ke Amazon S3 dengan URL yang dikembalikan dalam output. Defaultnya adalah mengunggah ke Amazon S3.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--start-time *START\$1TIME***
Menentukan awal rentang waktu, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya). `2021-01-01T20:00:00Z` Peristiwa log dengan stempel waktu yang sama dengan waktu ini atau lebih lambat dari waktu ini disertakan. Jika tidak ditentukan, defaultnya adalah waktu cluster dibuat.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
"url": "https://cluster-v3-bucket..."
}
```
## Tidak dapat mengambil log?
Jika Anda tidak dapat mengambil log menggunakan `export-cluster-logs` perintah, maka lakukan salah satu hal berikut:
+ Ambil log secara manual dari grup CloudWatch log cluster.
+ Jika grup log kosong, SSH ke node cluster dan mengambil log yang tercantum di. [Memecahkan masalah inisialisasi node](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init)
+ Jika node cluster tidak dapat diakses karena cluster gagal membuat, maka buat ulang cluster dengan opsi `--rollback-on-failure false` dan ambil log dari node.
# `pcluster export-image-logs`
Ekspor log tumpukan pembuat gambar ke `tar.gz` arsip lokal dengan melewati Amazon S3 Bucket.
```
pcluster export-image-logs [-h]
--image-id IMAGE_ID
[--bucket BUCKET]
[--bucket-prefix BUCKET_PREFIX]
[--debug]
[--end-time END_TIME]
[--keep-s3-objects KEEP_S3_OBJECTS]
[--output-file OUTPUT_FILE]
[--region REGION]
[--start-time START_TIME]
```
**catatan**
`export-image-logs`Perintah menunggu CloudWatch Log untuk menyelesaikan ekspor log, sehingga diharapkan mengalami periode waktu tanpa output apa pun.
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster export-image-logs`.
**--bucket *BUCKET\$1NAME***
Menentukan nama bucket Amazon S3 untuk mengekspor log build image ke. Itu harus di Wilayah yang sama dengan gambar.
+ Anda harus menambahkan izin ke kebijakan bucket Amazon S3 untuk CloudWatch memberikan akses. Untuk informasi selengkapnya, lihat [Menetapkan izin pada bucket Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) di CloudWatch Panduan Pengguna *Log*.
+ **Dimulai dengan AWS ParallelCluster versi **3.12.0**, `--bucket` opsi ini opsional.** Jika opsi tidak ditentukan, baik bucket default AWS ParallelCluster regional (`parallelcluster-hash-v1-DO-NOT-DELETE`) akan digunakan, atau jika `CustomS3Bucket` ditentukan dalam konfigurasi gambar, yang akan digunakan.
Jika bucket AWS ParallelCluster default digunakan, pcluster akan menangani konfigurasi kebijakan bucket. Jika Anda menyesuaikan kebijakan bucket sebelum memutakhirkan ke AWS ParallelCluster versi **3.12.0**, kebijakan bucket akan diganti dan Anda harus menerapkan kembali perubahan tersebut.
**--image-id, -i *IMAGE\$1ID***
ID gambar yang lognya akan diekspor.
**--bucket-prefix *BUCKET\$1PREFIX***
Menentukan jalur di bucket Amazon S3 tempat data log yang diekspor akan disimpan.
Secara default, awalan ember adalah:
```
ami-id-logs-202209061743.tar.gz
```
`202209061743`adalah waktu saat ini dalam `%Y%m%d%H%M` format.
Dimulai dengan AWS ParallelCluster versi **3.12.0**, jika Anda tidak menentukan `--bucket` opsi dan menggunakan AWS ParallelCluster bucket default, Anda tidak dapat mengekspor log ke `parallelcluster/` folder, karena ini adalah folder yang dilindungi yang dicadangkan untuk penggunaan internal.
**--debug**
Mengaktifkan logging debug.
**--end-time *END\$1TIME***
Menentukan akhir rentang waktu untuk mengumpulkan peristiwa log, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya `2021-01-01T20:00:00Z` '). Acara dengan stempel waktu yang sama dengan atau lebih lambat dari waktu ini tidak termasuk. Elemen waktu (misalnya menit dan detik) dapat dihilangkan. Nilai default adalah waktu ketika ini.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Jika`true`, objek yang diekspor ekspor ke Amazon S3 disimpan. (Default ke.) `false`
**--output-file *OUTPUT\$1FILE***
Menentukan path file untuk menyimpan arsip log ke. Jika ini disediakan, maka log disimpan secara lokal. Jika tidak, mereka diunggah ke Amazon S3 dengan URL yang dikembalikan dalam output. Defaultnya adalah mengunggah ke Amazon S3.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--start-time *START\$1TIME***
Menentukan awal rentang waktu, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya). `2021-01-01T20:00:00Z` Peristiwa log dengan stempel waktu yang sama dengan waktu ini atau lebih lambat dari waktu ini disertakan. Jika tidak ditentukan, defaultnya adalah waktu cluster dibuat.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
"url": "https://image-v3-bucket..."
}
```
# `pcluster get-cluster-log-events`
Ambil peristiwa yang terkait dengan aliran log.
```
pcluster get-cluster-log-events [-h]
--cluster-name CLUSTER_NAME
--log-stream-name LOG_STREAM_NAME
[--debug]
[--end-time END_TIME]
[--limit LIMIT]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
[--start-from-head START_FROM_HEAD]
[--start-time START_TIME]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster get-cluster-log-events`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--log-stream-name *LOG\$1STREAM\$1NAME***
Menentukan nama aliran log. Anda dapat menggunakan `list-cluster-log-streams` perintah untuk mengambil aliran log yang terkait dengan peristiwa atau peristiwa.
**--debug**
Mengaktifkan logging debug.
**--end-time *END\$1TIME***
Menentukan akhir rentang waktu, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya). `2021-01-01T20:00:00Z` Acara dengan stempel waktu yang sama dengan atau lebih lambat dari waktu ini tidak termasuk.
**--limit *LIMIT***
Menentukan jumlah maksimum peristiwa log dikembalikan. Jika nilai tidak ditentukan, maksimum adalah sebanyak peristiwa log yang dapat muat dalam ukuran respons 1 MB, hingga 10.000 peristiwa log.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--start-from-head *START\$1FROM\$1HEAD***
Jika nilainya`true`, peristiwa log paling awal dikembalikan terlebih dahulu. Jika nilainya`false`, peristiwa log terbaru dikembalikan terlebih dahulu. (Default ke.) `false`
**--start-time *START\$1TIME***
Menentukan awal rentang waktu, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya). `2021-01-01T20:00:00Z` Acara dengan stempel waktu yang sama dengan waktu ini atau lebih lambat dari waktu ini disertakan.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster get-cluster-log-events \
-c cluster-v3 \
-r us-east-1 \
--log-stream-name ip-198-51-100-44.i-1234567890abcdef0.clustermgtd \
--limit 3
{
"nextToken": "f/36966906399261933213029082268132291405859205452101451780/s",
"prevToken": "b/36966906399239632467830551644990755687586557090595471362/s",
"events": [
{
"message": "2022-07-12 19:16:53,379 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Performing node maintenance actions",
"timestamp": "2022-07-12T19:16:53.379Z"
},
{
"message": "2022-07-12 19:16:53,380 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Following nodes are currently in replacement: (x0) []",
"timestamp": "2022-07-12T19:16:53.380Z"
},
{
"message": "2022-07-12 19:16:53,380 - [slurm_plugin.clustermgtd:_terminate_orphaned_instances] - INFO - Checking for orphaned instance",
"timestamp": "2022-07-12T19:16:53.380Z"
}
]
}
```
# `pcluster get-cluster-stack-events`
Ambil peristiwa yang terkait dengan tumpukan untuk cluster yang ditentukan.
**catatan**
Mulai versi 3.6.0, AWS ParallelCluster menggunakan tumpukan bersarang untuk membuat sumber daya yang terkait dengan antrian dan sumber daya komputasi. `GetClusterStackEvents`API dan `pcluster get-cluster-stack-events` perintah hanya mengembalikan peristiwa tumpukan utama cluster. Anda dapat melihat peristiwa tumpukan cluster, termasuk yang terkait dengan antrian dan sumber daya komputasi, di konsol. CloudFormation
```
pcluster get-cluster-stack-events [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster get-cluster-stack-events`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster get-cluster-stack-events \
-n cluster-v3 \
-r us-east-1 \
--query "events[0]"
{
"eventId": "1234abcd-56ef-78gh-90ij-abcd1234efgh",
"physicalResourceId": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"resourceStatus": "CREATE_COMPLETE",
"stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"stackName": "cluster-v3",
"logicalResourceId": "cluster-v3",
"resourceType": "AWS::CloudFormation::Stack",
"timestamp": "2022-07-12T18:29:12.140Z"
}
```
# `pcluster get-image-log-events`
Ambil peristiwa log yang terkait dengan pembuatan gambar.
```
pcluster get-image-log-events [-h]
--image-id IMAGE_ID
--log-stream-name LOG_STREAM_NAME
[--debug]
[--end-time END_TIME]
[--limit LIMIT]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
[--start-from-head START_FROM_HEAD]
[--start-time START_TIME]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster get-image-log-events`.
**--image-id, -i *IMAGE\$1ID***
Menentukan Id gambar.
**--log-stream-name *LOG\$1STREAM\$1NAME***
Menentukan nama aliran log. Anda dapat menggunakan `list-image-log-streams` perintah untuk mengambil aliran log yang terkait dengan peristiwa atau peristiwa.
**--debug**
Mengaktifkan logging debug.
**--end-time *END\$1TIME***
Menentukan akhir rentang waktu, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya). `2021-01-01T20:00:00Z` Acara dengan stempel waktu yang sama dengan atau lebih lambat dari waktu ini tidak termasuk.
**--limit *LIMIT***
Menentukan jumlah maksimum peristiwa log dikembalikan. Jika nilai tidak ditentukan, maksimum adalah sebanyak peristiwa log yang dapat muat dalam ukuran respons 1 MB, hingga 10.000 peristiwa log.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--start-from-head *START\$1FROM\$1HEAD***
Jika nilainya`true`, peristiwa log paling awal dikembalikan terlebih dahulu. Jika nilainya`false`, peristiwa log terbaru dikembalikan terlebih dahulu. (Default ke.) `false`
**--start-time *START\$1TIME***
Menentukan awal rentang waktu, dinyatakan dalam format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, misalnya). `2021-01-01T20:00:00Z` Acara dengan stempel waktu yang sama dengan atau lebih lambat dari waktu ini disertakan.
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster get-image-log-events --image-id custom-alinux2-image --region us-east-1 --log-stream-name 3.1.2/1 --limit 3
{
"nextToken": "f/36778317771100849897800729464621464113270312017760944178/s",
"prevToken": "b/36778317766952911290874033560295820514557716777648586800/s",
"events": [
{
"message": "ExecuteBash: FINISHED EXECUTION",
"timestamp": "2022-04-05T22:13:26.633Z"
},
{
"message": "Document arn:aws:imagebuilder:us-east-1:123456789012:component/parallelclusterimage-test-1234abcd-56ef-78gh-90ij-abcd1234efgh/3.1.2/1",
"timestamp": "2022-04-05T22:13:26.741Z"
},
{
"message": "TOE has completed execution successfully",
"timestamp": "2022-04-05T22:13:26.819Z"
}
]
}
```
# `pcluster get-image-stack-events`
Ambil peristiwa yang terkait dengan tumpukan untuk build gambar yang ditentukan.
```
pcluster get-image-stack-events [-h]
--image-id IMAGE_ID
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster get-image-stack-events`.
**--image-id, -i *IMAGE\$1ID***
Menentukan ID gambar.
**--debug**
Mengaktifkan logging debug.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster get-image-stack-events --image-id custom-alinux2-image --region us-east-1 --query "events[0]"
{
"eventId": "ParallelClusterImage-CREATE_IN_PROGRESS-2022-04-05T21:39:24.725Z",
"physicalResourceId": "arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-custom-alinux2-image/3.1.2/1",
"resourceStatus": "CREATE_IN_PROGRESS",
"resourceStatusReason": "Resource creation Initiated",
"resourceProperties": "{\"InfrastructureConfigurationArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/parallelclusterimage-1234abcd-56ef-78gh-90ij-abcd1234efgh\",\"ImageRecipeArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/parallelclusterimage-custom-alinux2-image/3.1.2\",\"DistributionConfigurationArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:distribution-configuration/parallelclusterimage-1234abcd-56ef-78gh-90ij-abcd1234efgh\",\"EnhancedImageMetadataEnabled\":\"false\",\"Tags\":{\"parallelcluster:image_name\":\"custom-alinux2-image\",\"parallelcluster:image_id\":\"custom-alinux2-image\"}}",
"stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"stackName": "custom-alinux2-image",
"logicalResourceId": "ParallelClusterImage",
"resourceType": "AWS::ImageBuilder::Image",
"timestamp": "2022-04-05T21:39:24.725Z"
}
```
# `pcluster list-clusters`
Ambil daftar cluster yang ada.
```
pcluster list-clusters [-h]
[--cluster-status {CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
UPDATE_COMPLETE,UPDATE_FAILED}
[{CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
UPDATE_COMPLETE,UPDATE_FAILED} ...]]
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster list-clusters`.
**--cluster-status \$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 [\$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 ...]**
Menentukan daftar status cluster untuk memfilter untuk. (Default ke.) `all`
**--debug**
Mengaktifkan logging debug.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster list-clusters
{
"clusters": [
{
"clusterName": "cluster-v3",
"cloudformationStackStatus": "CREATE_COMPLETE",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "CREATE_COMPLETE"
}
]
}
```
# `pcluster list-cluster-log-streams`
Ambil daftar aliran log yang terkait dengan cluster.
```
pcluster list-cluster-log-streams [-h]
--cluster-name CLUSTER_NAME
[--filters FILTERS [FILTERS ...]]
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster list-cluster-log-streams`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--filters *FILTERS* [*FILTERS* ...]**
Menentukan filter untuk aliran log. Format: `Name=a,Values=1 Name=b,Values=2,3`. Filter yang didukung adalah:
`private-dns-name`
Menentukan bentuk singkat dari nama DNS pribadi dari instance (misalnya). `ip-10-0-0-101`
`node-type`
Menentukan jenis node, satu-satunya nilai yang diterima untuk filter ini adalah`HeadNode`.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster list-cluster-log-streams \
-n cluster-v3 \
-r us-east-1 \
--query 'logStreams[*].logStreamName'
[
"ip-172-31-58-205.i-1234567890abcdef0.cfn-init",
"ip-172-31-58-205.i-1234567890abcdef0.chef-client",
"ip-172-31-58-205.i-1234567890abcdef0.cloud-init",
"ip-172-31-58-205.i-1234567890abcdef0.clustermgtd",
"ip-172-31-58-205.i-1234567890abcdef0.slurmctld",
"ip-172-31-58-205.i-1234567890abcdef0.supervisord",
"ip-172-31-58-205.i-1234567890abcdef0.system-messages"
]
```
# `pcluster list-images`
Ambil daftar gambar kustom yang ada.
```
pcluster list-images [-h]
--image-status {AVAILABLE,PENDING,FAILED}
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster list-images`.
**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**
Filter gambar yang dikembalikan berdasarkan status yang disediakan.
**--debug**
Mengaktifkan logging debug.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster list-images --image-status AVAILABLE
{
"images": [
{
"imageId": "custom-alinux2-image",
"imageBuildStatus": "BUILD_COMPLETE",
"ec2AmiInfo": {
"amiId": "ami-1234abcd5678efgh"
},
"region": "us-east-1",
"version": "3.1.2"
}
]
}
```
# `pcluster list-image-log-streams`
Ambil daftar aliran log yang terkait dengan gambar.
```
pcluster list-image-log-streams [-h]
--image-id IMAGE_ID
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster list-image-log-streams`.
**--image-id, -i *IMAGE\$1ID***
Menentukan ID gambar.
**--debug**
Mengaktifkan logging debug.
**--next-token *NEXT\$1TOKEN***
Token untuk set hasil berikutnya.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster list-image-log-streams --image-id custom-alinux2-image --region us-east-1 --query 'logStreams[*].logStreamName'
[
"3.0.0/1",
"3.1.2/1"
]
```
# `pcluster list-official-images`
Jelaskan resmi AWS ParallelCluster AMIs.
```
pcluster list-official-images [-h]
[--architecture ARCHITECTURE]
[--debug]
[--os OS]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster list-official-images`.
**--architecture *ARCHITECTURE***
Menentukan arsitektur yang akan digunakan untuk menyaring hasil. Jika parameter ini tidak ditentukan, semua arsitektur dikembalikan.
**--debug**
Mengaktifkan logging debug.
**--os *OS***
Menentukan sistem operasi yang akan digunakan untuk menyaring hasil. Jika parameter ini tidak ditentukan, semua sistem operasi dikembalikan.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan pengaturan [Wilayah](image-builder-configuration-file-v3.md#yaml-build-image-Region) dalam file konfigurasi gambar, variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.2:**
```
$ pcluster list-official-images
{
"images": [
{
"amiId": "ami-015cfeb4e0d6306b2",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-x86_64-202202261505 2022-02-26T15-08-34.759Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-036f23237ce49d25b",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-x86_64-202202261505 2022-02-26T15-08-17.558Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-09e5327e694d89ef4",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.736Z",
"version": "3.1.2",
"architecture": "arm64"
},
{
"amiId": "ami-0b9b0874c35f626ae",
"os": "alinux2",
"name": "aws-parallelcluster-3.1.2-amzn2-hvm-x86_64-202202261505 2022-02-26T15-08-31.311Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-0d0de4f95f56374bc",
"os": "alinux2",
"name": "aws-parallelcluster-3.1.2-amzn2-hvm-arm64-202202261505 2022-02-26T15-08-46.088Z",
"version": "3.1.2",
"architecture": "arm64"
},
{
"amiId": "ami-0ebf7bc54b8740dc6",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.293Z",
"version": "3.1.2",
"architecture": "arm64"
}
]
}
```
# `pcluster ssh`
Menjalankan `ssh` perintah dengan nama pengguna cluster dan alamat IP yang telah diisi sebelumnya. Argumen arbitrer ditambahkan ke akhir `ssh` baris perintah.
```
pcluster ssh [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster ssh`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster untuk terhubung ke.
**--debug**
Mengaktifkan logging debug.
**--dryrun *DRYRUN***
Kapan`true`, mencetak baris perintah yang akan dijalankan dan keluar. (Default ke.) `false`
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
Contoh:
```
$ pcluster ssh --cluster-name mycluster -i ~/.ssh/id_rsa
```
Menjalankan `ssh` perintah dengan nama pengguna dan alamat IP cluster yang sudah terisi sebelumnya:
```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```
# `pcluster update-cluster`
Memperbarui cluster yang ada agar sesuai dengan pengaturan file konfigurasi yang ditentukan.
**catatan**
Pembaruan cluster hanya berhasil jika semua node cluster telah berhasil menerapkan pembaruan. Jika pembaruan gagal, lihat [Melihat `clusterStatus` adalah `UPDATE_FAILED` dengan `pcluster describe-cluster` perintah](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) bagian untuk panduan pemecahan masalah.
```
pcluster update-cluster [-h]
--cluster-configuration CLUSTER_CONFIGURATION
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--force-update FORCE_UPDATE]
[--query QUERY]
[--region REGION]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster update-cluster`.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
Menentukan file konfigurasi cluster YAMG.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--debug**
Mengaktifkan logging debug.
**--dryrun *DRYRUN***
Kapan`true`, melakukan validasi tanpa memperbarui cluster dan membuat sumber daya apa pun. Ini dapat digunakan untuk memvalidasi konfigurasi gambar dan memperbarui persyaratan. (Default ke.) `false`
**--force-update *FORCE\$1UPDATE***
Kapan`true`, memaksa pembaruan dengan mengabaikan kesalahan validasi pembaruan. (Default ke.) `false`
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan [`Region`](cluster-configuration-file-v3.md#yaml-Region)pengaturan dalam file konfigurasi cluster, variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**
Mengidentifikasi satu atau lebih validator konfigurasi untuk ditekan.
Format: (`ALL`\$1`type:[A-Za-z0-9]+`)
**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***
Menentukan tingkat kegagalan validasi dilaporkan untuk update.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster update-cluster -c cluster-config.yaml -n cluster-v3 -r us-east-1
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "UPDATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "UPDATE_IN_PROGRESS"
},
"changeSet": [
{
"parameter": "HeadNode.Iam.S3Access",
"requestedValue": {
"BucketName": "amzn-s3-demo-bucket1",
"KeyName": "output",
"EnableWriteAccess": false
}
},
{
"parameter": "HeadNode.Iam.S3Access",
"currentValue": {
"BucketName": "amzn-s3-demo-bucket2",
"KeyName": "logs",
"EnableWriteAccess": true
}
}
]
}
```
# `pcluster update-compute-fleet`
Memperbarui status armada komputasi cluster.
```
pcluster update-compute-fleet [-h]
--cluster-name CLUSTER_NAME
--status {START_REQUESTED,STOP_REQUESTED,ENABLED,DISABLED}
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster update-compute-fleet`.
**--cluster-name, -n *CLUSTER\$1NAME***
Menentukan nama cluster.
**--status \$1START\$1REQUESTED,STOP\$1REQUESTED,ENABLED,DISABLED\$1**
Menentukan status diterapkan ke armada komputasi cluster. Status `START_REQUESTED` dan `STOP_REQUESTED` sesuai dengan Slurm penjadwal sementara status `ENABLED` dan `DISABLED` sesuai dengan penjadwal. AWS Batch
**--debug**
Mengaktifkan logging debug.
**--query *QUERY***
Menentukan JMESPath query untuk melakukan pada output.
**--region, -r *REGION***
Menentukan Wilayah AWS untuk menggunakan. Wilayah AWS Harus ditentukan, menggunakan variabel `AWS_DEFAULT_REGION` lingkungan, `region` pengaturan di `[default]` bagian `~/.aws/config` file, atau `--region` parameter.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster update-compute-fleet -n cluster-v3 --status STOP_REQUESTED
{
"status": "STOP_REQUESTED",
"lastStatusUpdatedTime": "2022-07-12T20:19:47.653Z"
}
```
# `pcluster version`
Menampilkan versi AWS ParallelCluster.
```
pcluster version [-h] [--debug]
```
## Argumen bernama
**-h, --help**
Menampilkan teks bantuan untuk`pcluster version`.
**--debug**
Mengaktifkan logging debug.
**Contoh menggunakan AWS ParallelCluster versi 3.1.4:**
```
$ pcluster version
{
"version": "3.1.4"
}
```