Apple silicon - Private Networks API

Private Networks facilitate the interconnection of resources via a dedicated, private, and flexible L2 network.

This documentation describes the usage of the Private Network feature on Apple silicon servers.

You can multiple resources to your Private Networks, and can connect up to eight (8) distinct Private Networks per server, in the form of additional network interfaces within the server (VLANs). With this feature, you can isolate services from the public internet and expose them to the rest of your infrastructure without concern about public network filtering.

Servers can be added or removed from a Private Network at any time, even while running. The network interface will be hot-plugged into the server, and software can be configured to set it up automatically as soon as it appears.

(switchcolumn)

Concepts

Refer to our dedicated concepts pageOpen in new context to find definitions of all concepts and terminology related to Apple silicon servers.

Quickstart

(switchcolumn) (switchcolumn)

1. Configure your environment variables.

   Code
   export SCW_SECRET_KEY="<API secret key>"
   export SCW_DEFAULT_ZONE="<Scaleway Availability Zone>"
   export SCW_PROJECT_ID="<Scaleway Project ID>"

   Tip

   This is an optional step that seeks to simplify your usage of the Private Networks API. See Availability Zones below for help choosing an Availability Zone. You can find your Project ID in the Scaleway consoleOpen in new context.

2. Create a Private Network for your Apple silicon serverOpen in new context.

3. Add a server to the Private Network.

   Code
   curl -s -H "Content-Type: application/json" \
       -H "X-Auth-Token: $SECRET_KEY" \
       https://api.scaleway.com/apple-silicon/v1alpha1/zones/$SCW_DEFAULT_ZONE/servers/$EM_SERVER_ID/private-networks \
       -d '{"private_network_id": "'$PN_ID'"}'

   Note

   Keep the vlan field from the response. It is your VLAN ID, and will be used to configure the server to handle traffic from and to the Private Network.

4. Connect to your Apple silicon server and use the following command to configure your Private Network interface"

   Code
   sudo ip link add link eno1 name eno1.$VLAN type vlan id $VLAN
   sudo ip link set eno1.$VLAN up
   sudo ip addr add 192.168.0.10/24 dev eno1.$VLAN

(switchcolumn)

• You have a Scaleway accountOpen in new context
• You have created an API keyOpen in new context and that the API key has sufficient IAM permissionsOpen in new context to perform the actions described on this page
• You have installed curlOpen in new context

(switchcolumn)

Technical information

Pagination

Most listing requests receive a paginated response. Requests against paginated endpoints accept two query arguments:

• page, a positive integer to choose which page to return.
• page_size, a positive integer lower or equal to 100 to select the number of items to return per page. The default value is 20.

Paginated endpoints usually also accept filters to search and sort results. These filters are documented along each endpoint documentation.

Availability Zones

Private Networks for Apple silicon servers can be deployed in the following Availability Zones:

Technical limitations

• You need to configure a VLAN manually, using the Apple silicon server interface
• The bandwidth is limited to 1Gbps inside the Private Network
• You can configure up to 8 Private Networks per server
• Broadcast and multicast traffic, while supported, are rate-limited

Going further

For more help using Private Networks on Apple silicon servers, check out the following resources:

• Our main documentationOpen in new context
• The #virtual-private-cloud channel on our Slack CommunityOpen in new context
• Our support ticketing systemOpen in new context.