fix ansible and add conclusion

Author: Laure-di

tutorials/how-to-setup-applesilicon-server-with-terraform-ansible/index.mdx

@@ -118,32 +118,34 @@ This will apply the new settings, ensuring that the server is launched within th
 
 ### Using Ansible
 
-1. Install Ansible: You can install Ansible using pip, the Python package manager. Run the following command:
+1. Install Ansible:  If you don't have Ansible installed on your system, you can easily install it using pip, the Python package manager. Run the following command:
 
 ```shell
 pip install ansible
 ```
 
-2. Install Scaleway Ansible Collection: Run the following command to install the Scaleway collection for Ansible:
+2. Install Scaleway Ansible Collection: Scaleway provides an official Ansible collection that enables you to interact with Scaleway resources, such as creating servers. Install this collection using the ansible-galaxy command:
 
 ```shell
 ansible-galaxy collection install scaleway.scaleway
 ```
 
-3. Create a Directory: First, create a directory for your Ansible project. Open your terminal and run:
+3. Create a Directory: Now that you have Ansible and the Scaleway collection installed, create a directory for your Ansible project. This will help you keep everything organized.
+
+Run the following commands to create and navigate into the project directory:
 
 ```shell
 mkdir apple_silicon_server_ansible
 cd apple_silicon_server_ansible
 ```
 
-4. Create a Playbook: Create a new file named create_applesilicon_server.yml:
+4. Create a Playbook: In Ansible, a playbook is a YAML file that defines the tasks to automate. Create a new file for your playbook, named create_applesilicon_server.yml:
 
 ```shell
 touch create_applesilicon_server.yml
 ```
 
-5. Define the Playbook Content: Open create_applesilicon_server.yml in your text editor and add the following content:
+5. Define the Playbook Content: Open the create_applesilicon_server.yml file in your preferred text editor. Add the following content to define the task of provisioning an Apple Silicon server:
 
 ```ansible
 ---
@@ -156,31 +158,31 @@ touch create_applesilicon_server.yml
         access_key: "{{ scw_access_key }}"
         secret_key: "{{ scw_secret_key }}"
         state: present
-        type_: "M2-M"  # Replace with your desired server type
-        name: "my-applesilicon-server"  # Optional: specify a name for your server
-        zone: "fr-par-1"  # Optional: specify the zone if needed
-        project_id: "your_project_id"  # Optional: specify the project ID
+        type_: "M2-M"
+        name: "my-applesilicon-server"
+        zone: "fr-par-1"
+        project_id: "{{scw_project_id}}"
+        vpc_enabled: "false"
       register: applesilicon_server
-
-    - name: Output server information
-      debug:
-        var: applesilicon_server
 ```
 
-6. Ensure to replace your_project_id with your actual project ID if applicable.
+6. Set Up Your Scaleway Credentials: Replace the placeholders {{ scw_access_key }}, {{ scw_secret_key }}, and {{ scw_project_id }} with your actual credentials. It’s a good practice to store these values in environment variables or an Ansible vault for added security. Alternatively, you can use a .env file or an external credentials file.
+
+7. Run the Playbook: Now that your playbook is ready and your credentials are set, you can run the playbook to create your Apple Silicon server.
 
-7. Replace Placeholders: Ensure to replace your_project_id with your actual project ID if applicable.
+Execute the following command:
 
 ```shell
-ansible-playbook create_applesilicon_server.yml -e "scw_access_key=YOUR_ACCESS_KEY scw_secret_key=YOUR_SECRET_KEY"
+ansible-playbook create_applesilicon_server.yml
 ```
-Replace YOUR_ACCESS_KEY and YOUR_SECRET_KEY with your actual Scaleway credentials.
+
+Ansible will authenticate using your credentials, and the playbook will automatically provision the Apple Silicon server based on the defined parameters.
 
 8. Check the Output: The playbook will output the details of the created server, including its ID, IP address, status, and other relevant information.
 
-## How to read server info
+With these steps, you’ve successfully automated the creation of an Apple Silicon server on Scaleway using Ansible. You can now extend the playbook to configure your server or automate additional tasks as needed.
 
-### Using Terraform
+## How to read server info using Terraform
 
 To read server information after creation, you can use the terraform output command, assuming you have defined output variables in your resources.tf. For example:
 
@@ -197,5 +199,31 @@ After applying the configuration, run:
 terraform output server_ip
 ```
 
-### Using Ansible
+## Conclusion
+
+In this tutorial, we've explored how to automate the creation and management of Apple Silicon servers on Scaleway using two powerful tools: Terraform and Ansible. While both tools offer significant automation benefits, they each operate in distinct ways, which makes them suitable for different use cases.
+
+### Keys Differences
+
+#### Terraform's State Management
+
+Terraform maintains a state file that tracks the current status of your infrastructure. This state file acts as the source of truth for the resources created and managed by Terraform, providing you with visibility and control over any changes. This allows Terraform to efficiently handle infrastructure updates and deletions while ensuring consistency across environments.
+
+#### Ansible’s Idempotency
+
+Ansible, on the other hand, does not have a built-in state management system. Instead, it focuses on idempotency, meaning that Ansible playbooks can be executed multiple times without causing unwanted side effects. Each run checks whether the desired state is already achieved, and if not, it makes the necessary changes. However, Ansible doesn't retain a record of resource states, so it might be less efficient for large-scale infrastructure management compared to Terraform.
+
+### Which to choose?
+
+Terraform is an excellent choice for infrastructure provisioning where you need to keep track of your resources and manage dependencies between them. It is especially useful for handling lifecycle management (creation, modification, and deletion) of your infrastructure.
+
+Ansible shines in configuration management, automation, and orchestrating tasks across your infrastructure. It’s ideal for deploying applications, configuring services, and ensuring your systems are in the desired state after provisioning.
+
+You can also combine both tools for optimal results! Use Terraform for provisioning the infrastructure and Ansible for configuring the servers and deploying applications on top of it. This hybrid approach allows you to leverage the best of both worlds.
+
+By following this guide, you now have a solid understanding of how to automate the creation and management of Apple Silicon servers on Scaleway, whether you're using Terraform or Ansible. Both tools can greatly streamline your workflow, reduce manual effort, and help you maintain consistency across your infrastructure.
+
+For more advanced topics, consider exploring Terraform’s state management and Ansible’s playbook design to enhance your automation skills further. Happy automating!
+
+